Lo sviluppo guidato dalle specifiche — scrivi prima cosa deve fare il sistema, poi lasci che l’agente AI generi il codice a partire da quello — è, quando funziona, il modo più produttivo che ho visto per usare l’AI nello sviluppo software. L’agente non indovina, non riempie i vuoti a modo suo: esegue un progetto che hai già deciso tu.
Il problema è che questo scenario ideale è raro. Nella pratica, le specifiche complete all’inizio di un progetto non esistono quasi mai. Capisci cosa serve davvero mentre costruisci: un caso limite che non avevi previsto, un vincolo tecnico che emerge solo quando ci sbatti contro, un requisito che il cliente formula meglio dopo aver visto una prima versione. Pretendere la specifica completa prima di iniziare significa o bloccarsi in una fase di analisi infinita, o scrivere specifiche che sembrano complete e non lo sono.
La proposta: sviluppare aggiungendo, ma con una regola
Se le idee arrivano durante lo sviluppo, la soluzione non è fingere il contrario. È svilupparle man mano, normalmente — ma con un compito esplicito affidato all’agente fin dall’inizio: tenere una documentazione delle specifiche che venga aggiornata a ogni modifica, non alla fine, non “quando c’è tempo”.
Ogni volta che si aggiunge un’idea, si scopre un vincolo, si cambia una decisione, quella documentazione cambia insieme al codice. Non è una nota a margine: è il compito, tanto quanto scrivere la funzione stessa.
Il punto non è disciplina in più per il developer. È dare all’agente un’istruzione permanente, non una richiesta una tantum.
Il passaggio decisivo: ripartire da zero
Qui arriva la parte che quasi nessuno fa, ed è quella che fa la differenza. Alla fine dello sviluppo — quando la documentazione ha finito di accumulare tutte le decisioni prese strada facendo — non ci si ferma lì. Si riparte completamente da zero, fornendo all’agente quella documentazione come se fosse la specifica iniziale che non si aveva all’inizio.
Il codice che ne esce non è una versione rifinita del codice precedente. È un codice nuovo, scritto da chi (o cosa) conosce fin dal primo momento tutto quello che nella prima iterazione si è scoperto solo strada facendo.
Perché conta: una storia più breve
Il codice scritto in un solo passaggio, con la conoscenza completa disponibile da subito, ha una storia più breve di quello accumulato per aggiustamenti successivi. Meno strati di patch sopra decisioni superate. Meno commenti che spiegano perché una cosa è fatta in un modo che non ha più senso rivedere. Meno percorsi che esistono solo perché a un certo punto sembravano la soluzione più veloce.
Non è solo una questione estetica. Un codice con una storia più breve è più facile da leggere, da mantenere, da passare a qualcun altro — perché non porta dietro le tracce di ogni ripensamento, solo il risultato di averli già fatti tutti.


Leave a Reply