Comment donner à un agent de code une spécification exécutable

Les agents de code sont meilleurs quand la réussite est observable. Microsoft présente le spec-driven development autour d’une spécification vivante, versionnée et alignée sur le code et les tests.

1. Décrire le résultat

Commencez par l’utilisateur et le comportement visible.

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. Définir l’acceptation

Incluez le parcours normal, les états vides, les entrées invalides, les droits et les erreurs.

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. Inspecter avant de planifier

Demandez les routes, composants, accès aux données et tests concernés, puis un plan et les incertitudes. Vérifiez les contrats existants.

4. Rendre la spécification exécutable

Conservez-la dans un document versionné ou une issue réellement maintenue et reliez chaque critère à un test ou une vérification manuelle.

5. Garder des points de contrôle humains

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

6. Mettre à jour

La spécification n’est pas un prompt jetable. Actualisez-la quand les tests ou le produit changent et exigez une preuve pour chaque critère.