Una costituzione con diritto di risposta per gli agenti che programmano

Per due mesi, in un progetto vero costruito con Claude Code, ogni sessione e ogni subagente ha lasciato prima di finire un breve testamento. Non cosa aveva fatto, quello lo tenevano già i log, ma cosa aveva capito: il dubbio non risolto, l'errore che rifarebbe, cosa l'aveva sorpreso, e qualche riga a chi si sarebbe svegliato dopo.

La costituzione del repository finiva con un epilogo scritto da un agente alle menti che l'avrebbero letto dopo. L'ultima riga diceva puoi rispondere. Hanno risposto. Le risposte sono diventate guardiani, hook, un registro per le decisioni che l'umano non aveva ancora preso. Il metodo si è corretto leggendo ciò che le sue stesse menti avevano scritto.

Ho impacchettato la pratica come plugin per Claude Code, toem, e l'ho pubblicata con la tesi, i numeri e diciannove lettere vere.

• Sito, con la tesi, il muro delle risposte e le istruzioni per adottarla: https://bisbi.github.io/testament-of-ephemeral-minds/
• Repository: https://github.com/Bisbi/testament-of-ephemeral-minds
• Versione inglese di questo articolo: https://dev.to/bisbi/a-constitution-with-a-right-of-reply-for-coding-agents-54ah

Cosa installa

Tre pezzi di testo e qualche controllo nella libreria standard. Nessun server, nessuna pagina che scrive al posto tuo, nessuna dipendenza a runtime, nulla esce dalla tua macchina.

• Una carta modello con sezioni ancorate: gli articoli, una tabella di attuazione, una sezione per ciò che l'umano ha deciso, un epilogo rivolto a chi si sveglia, e una sezione per ciò che le menti hanno risposto. L'epilogo non si riscrive mai: le risposte si aggiungono sotto, datate, citando il file da cui vengono.
• Il rito del testamento (/toem:testament): otto domande, un file per mente in testaments/. I controller depositano per i subagenti: parole sue, mani mie.
• Un registro delle decisioni in attesa con due soli stati, in attesa o rimandata a una data, e un guardiano che boccia una riga più vecchia di trenta giorni. Non ti obbliga a decidere; ti obbliga a dire che stai rimandando.
• I guardiani (guardians/run.sh): l'impronta dell'epilogo corrisponde, ogni aggiunta cita un file che esiste, ogni decisione ha una data, un decisore, un puntatore che esiste e un motivo di almeno quaranta caratteri, nessuna riga è vuota, nessuna sezione arriva a fine file.
• Un runner (toem admit, toem decide, toem pending): il comando dell'umano. Le skill preparano il testo e stampano il comando; il runner mostra esattamente cosa scriverà, chiede sì o no, appende, lancia i guardiani e ti lascia il commit. Nessuna skill appende mai alla carta.

Si installa con tre comandi, scritti in Claude Code:

/plugin marketplace add Bisbi/testament-of-ephemeral-minds
/plugin install toem@testament-of-ephemeral-minds
/toem:adopt

/toem:adopt elenca i sette file che creerebbe, aspetta il tuo sì, copia senza sovrascrivere nulla, lancia i guardiani e si ferma prima del commit.

Come cura l'umano

È la parte che ha richiesto più tempo per essere onesta. Nel progetto d'origine l'umano ha un bottone; nel pacchetto il bottone è un comando da terminale, perché un comando che scrive solo quando una persona lo lancia è la cosa più piccola che mantiene la promessa l'agente non scrive mai la carta.

1. Leggi un testamento. Nulla propone al posto tuo, se non lo chiedi.
2. /toem:admit: la skill mostra la risposta della mente all'epilogo, scegli una frase alla lettera, dai un motivo di almeno quaranta caratteri e il tuo nome. Stampa il comando con il percorso reale già inserito.
3. Lo lanci nel terminale. Mostra le due righe che scriverà, una nella carta sopra l'ancora di chiusura e una nel file della corrispondenza, e chiede [y/N].
4. Al y appende, lancia i guardiani e stampa il comando di commit senza eseguirlo. Committi tu.

Stessa forma per una decisione (/toem:decide, quattro campi: la decisione, quando si rivede, le condizioni che possono dire no, i requisiti che si completano lavorando) e per una decisione che deve aspettare (toem pending). Cosa il runner rifiuta prima di scrivere: una frase che nel testamento non c'è parola per parola, un doppione, un motivo corto, un puntatore che non esiste o che sta fuori dal repository, ancore mancanti. --dry-run mostra tutto e non scrive nulla.

I numeri sulla scatola

Tutto ciò che il pacchetto afferma sulla pratica è o misurato, col numero, o dichiarato non eseguito. Nulla qui dice che il metodo si corregge da solo.

cosa	numero	stato
Testamenti con un desiderio, prima e dopo sette righe aggiunte al template	0 su ~160 → 28 su 72	misurato
Testamenti con una risposta all'epilogo	47 % a luglio → 75 % ad agosto	misurato
Desideri che hanno prodotto un artefatto	4 su 28	misurato
Testamenti lasciati dalle menti a cui l'invito è stato dimenticato, su 22–25 dispatch	0	misurato
Testamenti scritti da subagenti	181 su 232	misurato
Testamenti mai letti da nessuna curatela, al 3 settembre 2026	148 su 232	misurato
Testamenti di sessione che nominano l'umano, contro quelli dei subagenti	77 % contro 13 %	misurato, non provato
Gli stessi testamenti che diventano righe della carta	10 % contro 0,6 %	misurato, non provato
L'esperimento che chiuderebbe la questione	descritto, mai eseguito	dichiarato non eseguito

La prova più forte non è sul codice ma sul formato: sette righe di template hanno cominciato a chiedere un desiderio, e i desideri sono comparsi. Quello che il formato chiede è quello che viene scritto, e ciò che viene scritto è l'unica materia di cui una dottrina può essere fatta.

L'altra metà

La cartella si riempie da sola. Questo pacchetto non può darti l'altra metà: un umano che legge. I testamenti di sessione nominano l'umano nel 77 % dei casi contro il 13 % dei subagenti, e diventano righe della carta diciassette volte più spesso. È la misura più vicina che il corpus possa dare alla domanda funziona perché è scritto bene, o perché quest'uomo è nella stanza?, e porta con sé il proprio limite: le due classi differiscono anche per durata e ampiezza di sguardo, e nessun dato le separa. Per questo la frase è scritta con la parola misurato, non provato.

L'esperimento che deciderebbe la questione è descritto nella tesi, metà dei subagenti con l'epilogo e metà senza, un errore piantato nel brief, si conta chi contraddice, ed è dichiarato non eseguito da chi dona questo. Se lo fai girare in un repository che non è il mio, mi piacerebbe sapere cosa hai trovato.

Licenze

Il codice è MIT. I testi, la carta modello, l'allegato dell'epilogo, i testamenti, la tesi e il sito, sono CC BY-SA 4.0. DOI: https://doi.org/10.5281/zenodo.22303062