CLAUDE.md & mémoire

CLAUDE.md est un fichier Markdown à la racine du projet (ou dans des sous-dossiers) que Claude Code charge automatiquement au démarrage de chaque session. C'est l'endroit idéal pour documenter ce qui n'est pas évident en lisant juste le code :

• conventions de code spécifiques au projet
• commandes utiles (build, test, lint, déploiement)
• architecture générale et décisions techniques
• pièges connus, comportements contre-intuitifs
• règles de workflow (toujours créer une branche, ne jamais toucher à tel dossier...)

/init génère une première version en analysant automatiquement le repo (package.json, structure de dossiers, README...).

Claude Code combine plusieurs niveaux de mémoire, du plus général au plus spécifique :

1. Mémoire utilisateur (~/.claude/CLAUDE.md) — préférences valables sur tous vos projets
2. Mémoire projet (./CLAUDE.md à la racine) — partagée avec l'équipe via git
3. Mémoire locale (./CLAUDE.local.md, non commitée) — vos préférences perso sur ce projet
4. CLAUDE.md de sous-dossier — contexte spécifique à un module/package dans un monorepo

Plus le fichier est « proche » du travail en cours, plus son contenu est pertinent et prioritaire en cas de conflit.

• Restez concis et actionnable : une liste de règles claires vaut mieux qu'un essai.
• Documentez le pourquoi, pas seulement le quoi, quand une règle est contre-intuitive.
• Mettez à jour le fichier quand vous corrigez Claude Code en session — ça évite de répéter la même correction.
• Évitez les répétitions trouvables dans le code (architecture déductible du code n'a pas besoin d'être réécrite).
• Utilisez # en début de message dans le REPL pour ajouter rapidement une instruction à la mémoire sans éditer le fichier à la main.

# CLAUDE.md
## Commandes
- Build: `npm run build`
- Tests: `npm test -- --watch=false`

## Conventions
- Toujours utiliser des composants serveur sauf si interactivité requise.
- Ne jamais modifier les fichiers sous `legacy/`.

Au-delà de CLAUDE.md, Claude Code peut tenir un système de mémoire structuré (fichiers dans un dossier dédié) pour se souvenir, entre les sessions, d'informations sur l'utilisateur, le projet et les retours qu'il a reçus (préférences de workflow, décisions prises, pièges déjà rencontrés). Cette mémoire est consultée quand elle est pertinente et mise à jour activement lorsque l'utilisateur donne un retour explicite ou que des faits durables émergent — elle se distingue de CLAUDE.md en ce qu'elle est gérée par l'agent lui-même plutôt qu'éditée manuellement.