In questi giorni sto avendo le ennesime conferme di quanto sia un buon investimento investire tempo nello scrivere per bene cosa si vuole a un coding agent.

Cosa significa “bene”?

Significa che quando avvio una sessione con l’intenzione di implementare qualcosa (e non semplici refactoring o rifiniture) mi assicuro di indicare:

  • La formuletta della user story “Come [tipo di utente], voglio [azione] in modo da [beneficio]”
  • La maggior parte degli acceptance criteria, possibilmente in forma Gherkin / Given-When-Then
  • Eventuali vincoli tecnici o di design che devono essere rispettati
  • Cose non ancora definite o poco chiare
  • Riferimenti utili a implementazioni simili, se presenti

Plan

A quest punto prendo tutto questo e lo uso nella modalità plan dell’agent di turno (io uso il mio plan-on-roids agent di GitHub Copilot). Il piano che ne viene fuori dopo l’analisi è di altissima qualità (che leggo velocemente).

Implementazione

Con il piano in mano passo poi all’implementazione in cui mi assicuro di… lo vedremo nel prossimo messaggio!