Como dar a um agente de código uma especificação executável

Agentes de código funcionam melhor quando o sucesso é observável. A Microsoft descreve spec-driven development com uma especificação viva, versionada e sincronizada com código e testes.

1. Escreva o resultado

Comece pelo usuário e pelo comportamento visível.

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. Defina a aceitação

Inclua caminho normal, estados vazios, entrada inválida, permissões e falhas.

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. Inspecione antes de planejar

Peça ao agente para encontrar rotas, componentes, acesso a dados e testes, e depois mostrar plano e dúvidas. Verifique os contratos existentes.

4. Torne executável

Guarde a especificação em um documento versionado ou issue mantido pela equipe e ligue cada critério a um teste ou verificação manual.

5. Mantenha revisão humana

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

6. Atualize

A especificação não é um prompt descartável. Atualize-a quando testes ou decisões mudarem e peça evidência de cada critério.