Aller au contenu
Module
Module 4 sur 5Leçon 2 sur 3~16 min

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

Tout le glossaire

Guide sur ce thème

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

  1. Ce dont un agent de code a besoin
  2. Le fichier d'intention et les conventions du dépôt (cette leçon)
  3. 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