Chaîne spécification → plan → PR
Une fonctionnalité confiée à un agent suit une chaîne courte : une spécification avec critères testables, un plan de fichiers ordonné, une implémentation bornée, puis une revue humaine.
- spec
- spécification
- user story
- plan
- pull request
- review
Syntaxe
Récit utilisateur + critères testables → plan ordonné (schéma → API → interface)→ agent (périmètre limité) → revue humaine → fusionExemple
Récit : « En tant qu'enseignant, je télécharge les notes de ma classe en CSV. »Critères : - 401 si l'utilisateur n'est pas connecté, 403 si la classe n'est pas la sienne - sinon 200 et un CSV aux colonnes eleve, lecon, scoreHors objectif : export PDFPlan : 1. route API 2. bouton sur la page de la classe 3. test de la routeRésultat attendu : une PR de trois fichiers dont les tests reprennent les trois critères,relue par un humain avant fusion.À retenir
- Découpez en tranches verticales : une petite fonctionnalité complète vaut mieux qu'une couche entière à moitié faite.
- Un prompt d'agent correspond à une étape du plan et à un périmètre de fichiers limité.
- Les critères testables deviennent les tests : demandez à l'agent de les écrire avant le code.
- Piège : fusionner parce que la CI est verte. La CI ne vérifie que ce qu'on lui a demandé ; la revue humaine vérifie que la PR fait ce que dit la spécification, et rien de plus.
Voir aussi
- Chaîne maquette → spécification → codePour passer d'une maquette à du code avec l'IA, on intercale une spécification écrite et validée : la maquette fixe le visuel, la spécification le comportement, et l'agent implémente.
- Brief de sessionUn agent travaille comme un prestataire : il lui faut un but, ce qui est hors périmètre, les fichiers concernés et un critère de fin observable. « Améliore la landing » n'est pas un brief.
- Chat, Plan ou AgentTrois niveaux d'autonomie : le chat explique sans toucher aux fichiers, le plan fait valider les étapes avant le code, l'agent modifie et exécute dans les limites d'un brief.