Aller au contenu
Floskool

Chapitre 3 · Chapitre 3 · Préparer son projet avant de demander un plan

3.2 Donner du contexte durable avec CLAUDE.md

Leçon gratuite 6 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Le brief décrit ce projet. Mais certaines informations restent vraies pendant toute la durée du projet : ton style de travail, tes préférences techniques, les règles à toujours respecter. Ces informations ont leur place dans le fichier CLAUDE.md.

Ce qu'est CLAUDE.md

D'après la documentation officielle, CLAUDE.md est un fichier d'instructions que Claude Code charge au démarrage de chaque session. Pour un projet, il se place à la racine (./CLAUDE.md ou ./.claude/CLAUDE.md). La commande /init peut en générer une première version à partir de ton projet (et s'il en existe déjà un, elle propose des améliorations). La commande /memory permet ensuite de l'éditer.

Il existe d'autres emplacements, utiles plus tard :

  • ~/.claude/CLAUDE.md : tes règles personnelles, pour tous tes projets ;
  • ./CLAUDE.local.md : tes règles personnelles pour ce projet seulement, à garder hors du partage.

La documentation précise que ces fichiers s'additionnent : ils ne se remplacent pas les uns les autres.

Ce que tu peux y mettre pour mieux planifier

# Projet : site de réservation du salon

## Toujours
- Lire BRIEF.md avant de proposer un plan.
- Lister les informations manquantes avant de coder.
- Proposer un découpage en petites étapes vérifiables.
- Expliquer chaque choix technique en une phrase simple.

## Jamais
- Ajouter une fonctionnalité qui n'est pas dans le brief sans me le demander.
- Stocker des données personnelles sans me prévenir.

Chaque ligne a une raison d'être. « Lire BRIEF.md » évite de répéter le contexte. « Lister les informations manquantes » transforme les suppositions en questions. « Petites étapes vérifiables » prépare l'exécution du chapitre 6. « Expliquer chaque choix en une phrase » t'aide à comprendre ce que tu approuves.

Le pas à pas

  1. Dans ton dossier de projet, lance Claude Code.
  2. Tape /init pour obtenir une première version, ou crée le fichier toi-même avec le modèle ci-dessus.
  3. Relis ce que /init a produit : garde ce qui est juste, ajoute tes règles « Toujours / Jamais ».
  4. Pour l'éditer plus tard, utilise /memory ou ouvre le fichier dans ton éditeur.

Tu peux aussi demander à Claude, au fil d'une session, d'ajouter une règle : « ajoute à CLAUDE.md : toujours me demander avant d'installer un outil ».

Garder un CLAUDE.md court

La documentation conseille de viser moins de 200 lignes par fichier CLAUDE.md. Ce fichier est chargé à chaque session et occupe de la place dans le contexte de Claude. Mets-y des règles durables, pas l'histoire complète du projet : le détail va dans BRIEF.md et, plus tard, dans PLAN.md.

Attention aux contradictions

Si ton brief dit « pas de paiement en ligne » et que ton CLAUDE.md dit « toujours proposer le paiement », Claude devra choisir. La documentation précise que des instructions contradictoires peuvent mener à un choix arbitraire. Relis tes fichiers pour qu'ils disent la même chose.

Une demande pour le vérifier :

Relis CLAUDE.md et BRIEF.md. Signale-moi toute consigne qui se contredit
ou qui est ambiguë, sans rien modifier.

Si ça coince

  • Claude semble ignorer ton CLAUDE.md. Vérifie qu'il est bien à la racine du dossier ouvert, et que son nom est exact. La commande /context montre les fichiers CLAUDE.md chargés dans la session.
  • Tu as lu qu'on pouvait ajouter une mémoire avec #. Ce raccourci n'apparaît plus dans la documentation actuelle. Dis plutôt « ajoute ceci à CLAUDE.md » ou utilise /memory.
  • /init a produit un fichier très technique. C'est normal sur un projet qui contient déjà du code. Garde-le, et ajoute tes règles en langage simple en tête de fichier.

À retenir

  • Le brief décrit le projet ; CLAUDE.md donne des règles durables, chargées à chaque session.
  • /init crée une première version, /memory sert à l'éditer.
  • Une règle « liste ce qui manque avant de coder » améliore tous tes plans.
  • Évite les consignes contradictoires entre tes fichiers, et garde CLAUDE.md court.