CLAUDE.md : la mémoire qui se compose

Le problème de la session vierge

À chaque nouvelle session, Claude repart de zéro. Tu réexpliques le projet, les conventions, où sont les fichiers, comment référencer la clé API… C'est une perte de temps répétée, mais c'est pire que ça : c'est une perte de fiabilité. Un jour tu oublies de mentionner une convention, et Claude affiche une clé API en clair dans une commande ou range un fichier au mauvais endroit. La qualité de ton système dépend alors de ta mémoire du moment — exactement ce qu'on cherche à éliminer depuis le début du cours.

La solution s'appelle CLAUDE.md. C'est un fichier à la racine de ton projet que Claude Code lit au démarrage de chaque session, avant même ton premier message. Tout ce que tu y mets devient du contexte persistant : Claude le connaît avant que tu parles. C'est la différence entre un intérimaire qu'on rebriefe chaque matin et un collaborateur qui connaît la maison.

Une mémoire à plusieurs étages

CLAUDE.md n'existe pas qu'à la racine du projet. Claude Code lit en réalité une hiérarchie de fichiers mémoire, du plus général au plus spécifique : ton fichier personnel ~/.claude/CLAUDE.md (tes préférences valables dans tous tes projets — langue, style de réponse, conventions personnelles), le CLAUDE.md du projet (versionné dans Git, partagé avec l'équipe), et d'éventuels CLAUDE.md dans des sous-dossiers pour les règles propres à une partie du projet.

• ~/.claude/CLAUDE.md — tes préférences personnelles, tous projets confondus.
• CLAUDE.md à la racine du projet — conventions et contexte du projet, partagés via Git.
• sous-dossier/CLAUDE.md — règles spécifiques à une zone, chargées quand Claude y travaille.

Cette hiérarchie répond à la question « où mettre quoi ». La règle est la même qu'au chapitre 3 pour les skills : ce qui est personnel va chez toi, ce qui appartient au projet va dans le projet. « Réponds-moi toujours en français » → personnel. « La clé API se référence via le fichier .env, jamais en clair » → projet.

Créer ton CLAUDE.md

Deux chemins possibles. Le premier : la commande /init, qui analyse ton projet et génère un premier CLAUDE.md — c'est le bon réflexe sur un projet existant que Claude ne connaît pas. Le second, plus précis pour notre cas : demander à Claude de codifier ce que vous avez construit ensemble, puisqu'il a tout le contexte. Colle ce prompt :

crée un fichier CLAUDE.md qui codifie tout ce qu'on a construit dans ce projet :
- lien vers la doc de l'API utilisée
- où se trouve la clé API et comment la référencer dans les commandes
- conventions de commandes (toujours inline, etc.)
- lien vers le fichier de voix de marque
- lien vers la config du quality gate
- lien vers le journal des posts
- tout autre pattern qu'on a établi

Claude parcourt le projet, rassemble les patterns récurrents qui ont bien marché, et les codifie. Désormais chaque session démarre avec tout le contexte : la structure du projet de Léa, ses conventions, ses garde-fous. Ouvre le fichier généré et lis-le — c'est la photographie de tout ce que tu as appris dans ce cours.

Ce qui va dans CLAUDE.md (et ce qui n'y va pas)

La tentation, une fois le mécanisme compris, est d'y mettre tout. Erreur : CLAUDE.md est chargé dans le contexte de chaque session, chaque mot a donc un coût permanent. Un fichier de 400 lignes encombre toutes tes conversations avec des détails inutiles 95% du temps — exactement le bruit qu'on combat depuis le chapitre 2. La cible : un fichier court et dense, où chaque ligne mérite d'être lue à chaque session.

Le raccourci # : mémoriser à la volée

Maintenir cette mémoire ne doit pas être une corvée, sinon tu ne le feras pas. Claude Code a un raccourci dédié : commence un message par # et ce que tu écris est proposé à l'ajout dans la mémoire, sans interrompre ton travail. En pleine session, tu remarques que Claude a encore utilisé un format de date qui te déplaît ? Tape # les dates sont toujours au format JJ/MM/AAAA — la règle est capturée, la session continue.

L'autre mécanisme d'entretien, plus structurel : en fin de session de travail riche, demande « relis notre conversation et mets à jour CLAUDE.md avec les patterns qu'on a établis ». Claude extrait les décisions durables de la conversation et les fond dans la mémoire. C'est l'équivalent du compte rendu de réunion — dix secondes à demander, et rien ne se perd.

Le savoir qui se compose

Comme tes skills, ton CLAUDE.md évolue en continu — et c'est cette boucle qui change tout. Chaque session construit sur la précédente au lieu de repartir de zéro : c'est ainsi que ton expertise se compose dans le temps, au sens des intérêts composés. La plupart des gens utilisent l'IA de façon linéaire : 100 sessions, 100 fois le même niveau. Avec une mémoire entretenue, ta session 100 démarre avec le condensé des 99 précédentes.

flowchart LR
  S["Session de travail"] --> U["« mets à jour CLAUDE.md »"]
  U --> M["CLAUDE.md enrichi"]
  M -->|"Lu au démarrage"| N["Nouvelle session"]
  N --> S

Et la boucle se referme avec le chapitre 2 : tu peux maintenant faire /clear sans état d'âme. Le bruit conversationnel disparaît, l'essentiel revient par CLAUDE.md. Contexte propre et mémoire durable — les deux exigences qui semblaient contradictoires au début du cours sont réconciliées.

Et maintenant ?

Fais le bilan du système de Léa : un skill /post multi-plateforme avec sa voix de marque, un quality gate qui rend les erreurs publiques impossibles, des subagents qui publient en parallèle, une commande /plan-week qui orchestre la semaine, et une mémoire projet qui fait tenir le tout dans la durée. Léa tape une phrase ; le système fait le reste, sous son contrôle.

Pour aller plus loin, trois directions naturelles : brancher davantage d'outils externes via MCP (CRM, analytics, calendriers — la commande claude mcp add est ton point d'entrée), explorer le mode navigateur pour que Claude teste lui-même ce qu'il publie, et surtout : rejouer la méthode de ce cours sur un autre processus de ta vie professionnelle. La méthode — skill, garde-fou, parallélisation, validation, mémoire — est le vrai livrable de ce cours. Léa n'était que le prétexte.