Ce dont un agent de code a besoin
Un agent de code produit vite un résultat plausible, mais il comble les manques d'une consigne par ses propres suppositions. Cette leçon vous apprend à transformer une spec en consigne complète pour un agent, et à savoir quoi exiger de lui pour juger que le travail est vraiment terminé avant de le valider.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de transformer une spec en consigne autonome pour un agent de code : contexte, fichiers et interfaces concernés, contraintes, hors périmètre et définition de terminé avec une étape de vérification qu'il peut exécuter.
Thèmes abordés
- agents de code
- consigne pour agent de code
- définition de terminé
- développement assisté par IA
- spec pour agent IA
Dans quel module
Des specs pour les agents de code
Que faut-il écrire pour qu'un agent de code IA construise la bonne chose, et comment le vérifier avant et après ?
Leçons du module
- Ce dont un agent de code a besoin (cette leçon)
- Le fichier d'intention et les conventions du dépôt
- Relire le plan d'un agent contre la spec
Ce que vous apprendrez dans la formation
Cette leçon fait partie de la formation Écrire des specs que les développeurs et les agents IA comprennent
- Choisir le niveau de spec adapté à la décision à prendre (PRD, spec de fonctionnalité, ticket) et savoir ce que chacun doit contenir.
- Formuler l'intention d'une fonctionnalité (problème, résultat visé, contraintes, non-objectifs) séparément de la solution, pour laisser la bonne marge à l'équipe et à l'agent.
- Écrire des critères d'acceptation Given/When/Then vérifiables, déclaratifs et sans ambiguïté, y compris sous forme de tableaux d'exemples.
- Identifier les cas limites et les exigences non fonctionnelles (performance, sécurité, accessibilité, données personnelles) et les rendre testables.
- Rédiger une spec et un fichier d'intention exploitables par un agent de code (contexte, contraintes, fichiers concernés, hors périmètre, définition de terminé vérifiable).
- Relire le plan d'un agent de code contre la spec, repérer les écarts avant qu'il code, puis vérifier les preuves de ce qui a été livré.
- Garder une spec vivante (versions, décisions, mises à jour quand le code révèle un cas) et repérer les anti-patterns qui la rendent inutile.
Formations liées
- Concevoir et valider une expérience produit avec l'IAJunior · ~2 h 30 min
- Instrumenter un produit et utiliser les données pour déciderConfirmé · ~3 h 30 min
- Prioriser et construire une roadmap orientée résultatsConfirmé · ~2 h 30 min