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.
Mis à jour le 29 septembre 2026.
En bref
Un agent de code a besoin d'une consigne autonome : le contexte, les fichiers et interfaces concernés, les contraintes, ce qui est hors périmètre et une définition de terminé qu'il peut vérifier lui-même. Sans cela, il comble les manques par des suppositions. Pour un PM, c'est la condition pour obtenir un résultat juste, pas seulement plausible.
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.
Les questions auxquelles cette leçon répond
Comment donner une consigne claire à un agent de code comme Claude Code ?
En lui donnant tout ce qu'un nouveau développeur devrait savoir : l'objectif, le contexte du code, les contraintes, les limites du périmètre et la façon de vérifier le résultat. Ce qui n'est pas écrit sera supposé.
Comment savoir si le travail d'un agent de code est vraiment terminé ?
On fixe à l'avance une définition de terminé assortie d'une vérification exécutable, tests ou contrôle observable. On exige ensuite la preuve que cette vérification a été faite, pas seulement l'annonce que c'est fini.
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 le glossaire
Guide sur ce thème
- Écrire une spec pour agent IA
Les sections d’une spec qu’un agent de code exécute sans deviner, avec un modèle SPEC.md.
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 ce module
Cette leçon fait partie de la formation Écrire des specs que les développeurs et les agents IA comprennent
- 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
- IA & DéveloppementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Travailler avec Claude Code sur un vrai projet : contexte, plan, revue
3 h
- IA & DéveloppementJuniorQuelques bases utiles : notions de contexte ou du domaine.
Construire et mettre en ligne une app web avec un agent de code IA
2 h 45 min
- IA & ProductivitéConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Créer des Claude Skills fiables pour votre travail produit
2 h 30 min