Come dare a un coding agent una specifica eseguibile

Gli agent funzionano meglio quando il successo è osservabile. Microsoft descrive lo spec-driven development come una specifica viva, versionata e sincronizzata con codice e test.

1. Descrivi il risultato

Parti dall’utente e dal comportamento visibile.

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. Definisci l’accettazione

Includi percorso normale, stati vuoti, input non valido, permessi ed errori.

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. Ispeziona prima del piano

Chiedi all’agent di trovare route, componenti, accesso ai dati e test, poi di presentare piano e dubbi. Controlla i contratti esistenti.

4. Rendi la specifica eseguibile

Conservala in un documento versionato o issue mantenuto dal team e collega ogni criterio a un test o controllo manuale.

5. Mantieni la revisione umana

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. Aggiorna

La specifica non è un prompt usa e getta. Aggiornala quando cambiano test o prodotto e chiedi prove per ogni criterio.