Cómo dar a un agente de código una especificación ejecutable

Los agentes de código funcionan mejor cuando el resultado está definido. Microsoft describe el desarrollo guiado por especificaciones como una especificación viva, versionada y sincronizada con código y pruebas.

1. Escribe el resultado

Empieza por el usuario y el comportamiento observable.

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. Define la aceptación

Incluye camino normal, estados vacíos, entradas inválidas, permisos y errores.

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. Inspección antes del plan

Pide al agente que encuentre rutas, componentes, acceso a datos y tests, y que exponga un plan y sus dudas. Revisa que conserve los contratos existentes.

4. Hazla ejecutable

Guarda la especificación en un documento versionado o issue que el equipo mantenga, y vincula cada criterio con una prueba o comprobación manual.

5. Mantén revisión humana

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

6. Actualiza con la realidad

La especificación no es un prompt desechable. Actualízala cuando cambien las reglas y exige evidencia de cada criterio antes de terminar.