Ogni cambiamento che vale la pena costruire comincia con un'intenzione

Una settimana di SDD: da una prima versione a uno strumento che controlla il proprio lavoro.

Di giorno sono un ingegnere del software e architetto senior. La sera e nei fine settimana dipingo con il nome di Sam Grudge: cuori, a olio su tela, costruiti strato dopo strato finché il colore risplende (hearts-colors.com). Le due vite sembrano molto distanti. Sempre più spesso si incontrano in un'unica domanda: cosa voglio fare con le mie stesse mani, e cosa posso affidare a una macchina?

SDD nasce dal mio lavoro quotidiano. È una metodologia di sviluppo guidata dalle specifiche per agenti di programmazione IA (Claude Code e Codex), ed è open source su GitHub. L'idea è semplice. Prima che l'agente scriva codice, redige una breve specifica: requisiti ed esempi concreti di come dovrebbero comportarsi, anche quando le cose vanno storte. Io la approvo. Poi l'agente la costruisce partendo dai test, la verifica rispetto alla specifica, e mantiene un registro vivo di come si comporta il sistema.

Cosa è cambiato in una settimana

La prima versione è uscita il 7 ottobre. Gestiva piccole modifiche dall'inizio alla fine, con una sola approvazione, compiti basati su test-prima e una specifica viva. Sette giorni e quattordici versioni dopo:

• I lavori più grandi seguono un proprio percorso. Una modifica più ampia riceve tre approvazioni invece di una: la specifica, il piano e i risultati.
• Una specifica approvata viene bloccata. Modificarla successivamente richiede un emendamento registrato e approvato. I bug seguono un proprio flusso, e un test di regressione viene aggiunto alla specifica viva affinché il bug non possa tornare silenziosamente.
• Un critico esamina la specifica prima che venga costruito qualcosa. Verifica ogni requisito e mi pone solo le domande che spettano a me decidere, al massimo cinque.
• SDD ora sviluppa SDD. Dalla versione 0.5, il progetto funziona secondo il proprio metodo, con un rigore di "produzione": il secondo più alto dei suoi quattro livelli.
• La suite di test è passata da 82 a 208 test.

Lo strumento ha trovato falle in se stesso

Il primo cambiamento che SDD ha applicato a se stesso è stato un bug che aveva scoperto nelle proprie approvazioni. L'approvazione finale dei "risultati" non leggeva il verdetto del revisore, quindi un lavoro segnalato come carente poteva comunque essere approvato. La costituzione del progetto, le sue regole non negoziabili, poteva essere modificata dopo l'approvazione senza che nessuno se ne accorgesse, incluso l'abbassamento del livello di rigore.

Entrambi i problemi sono stati risolti. Un'approvazione ora copre esattamente ciò che è stato approvato. Il controllo dei risultati accetta solo un verdetto positivo, e la costituzione porta un'impronta: qualsiasi modifica successiva viene segnalata e blocca l'avanzamento finché non approvo di nuovo.

Ciò che mi è piaciuto di più è stato come si è arrivati a questo. La verifica è stata eseguita tre volte, ciascuna in una sessione nuova senza memoria del lavoro precedente. I primi due round hanno rivelato lacune: regole che la specifica stabiliva ma nessun test dimostrava. Ogni volta, la specifica è stata modificata, i test mancanti scritti, e il revisore ha controllato di nuovo. Il terzo round è stato superato. Nulla è stato approvato senza verifica.

Strati

Un mio dipinto è fatto di strati. I primi scompaiono sotto il colore, ma reggono tutto. SDD funziona allo stesso modo: intenzione, poi specifica, piano, test e verifica, ciascuno visibile e verificabile sotto il codice.

Sul mio sito dico che ogni storia che merita di essere raccontata comincia con un cuore. Nel software, ogni cambiamento che merita di essere costruito comincia con un'intenzione. Quella parte resta mia. Così come le decisioni e le approvazioni, che portano le mie stesse parole.

Delegare la fatica

Non ogni strato richiede la mano di un maestro. Un round di verifica richiedeva circa 14 minuti e quasi 180.000 token, e gran parte di questo era meccanico: rieseguire i test sul vecchio codice, infrangere deliberatamente le regole per dimostrare che un test le intercetta, raccogliere prove. Uno script può fare quel lavoro, senza alcun modello.

Questo è il prossimo passo. Un modello principale orchestrerà: parlerà con me, presidierà i controlli e smisterà il lavoro. I revisori indipendenti funzioneranno come agenti separati sui modelli più potenti. I compiti di routine andranno a modelli più economici e veloci. Ogni tipo di lavoro va allo strumento adatto, così come un pennello si adatta a un tratto e una spatola a un altro.

Questa è la promessa dell'IA che mi sta a cuore. Non toglie il mestiere. Toglie la fatica che lo circonda, così che io conservi la parte che amo. In ufficio è architettura e giudizio. In studio, è il prossimo cuore.

SDD è open source sotto licenza MIT: github.com/fpapleux/sdd-skill. Le note di rilascio elencano ogni versione.