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.

Suivre cette leçon : première formation offerteVoir le programme complet

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).

Thèmes abordés

  • fichier d'intention
  • CLAUDE.md
  • AGENTS.md
  • conventions du dépôt
  • agents de code

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

  • 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