Le fichier d'intention et les conventions du dépôt
Pour qu'un agent de code respecte ce que vous voulez construire, il doit le trouver dans le dépôt, sous une forme qu'il sait lire. Cette leçon montre ce qu'un fichier d'intention apporte à une fonctionnalité, comment il s'articule avec la spec et avec CLAUDE.md ou AGENTS.md, et ce que ces fichiers ne garantissent pas.
Mis à jour le 29 septembre 2026.
En bref
Un fichier d'intention est un document versionné dans le dépôt de code qui décrit ce qu'une fonctionnalité doit accomplir et pourquoi, sous une forme lisible par un agent de code. Il complète la spec et les fichiers d'instructions comme CLAUDE.md ou AGENTS.md. Pour un PM, c'est le moyen de garder l'intention produit à portée des agents.
Objectif de la leçon
À la fin de cette leçon, vous serez capable d'écrire le fichier d'intention versionné d'une fonctionnalité et de répartir les informations entre ce fichier, la spec et le fichier d'instructions du dépôt (CLAUDE.md ou AGENTS.md).
Les questions auxquelles cette leçon répond
Qu'est-ce qu'un fichier d'intention dans un dépôt de code ?
C'est un fichier placé à côté du code qui résume le but d'une fonctionnalité, ses règles et ses limites. Versionné avec le code, il reste visible pour l'équipe et pour les agents qui travaillent dans le dépôt.
Que mettre dans CLAUDE.md ou AGENTS.md plutôt que dans la spec ?
Les conventions qui valent pour tout le dépôt : commandes de build et de test, style de code, règles de l'équipe. La spec, elle, décrit une fonctionnalité précise et son comportement attendu.
Thèmes abordés
- fichier d'intention
- CLAUDE.md
- AGENTS.md
- conventions du dépôt
- agents de code
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
- Le fichier d'intention et les conventions du dépôt (cette leçon)
- 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
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
- Product ManagementJuniorQuelques bases utiles : notions de contexte ou du domaine.
Concevoir et valider une expérience produit avec l'IA
2 h 30 min
- Product ManagementConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Installer une discovery continue avec l'IA
3 h 4 min