# CLAUDE.md — Mémoire persistante Claude Code > Contexte spécialisé pour Claude Code. À utiliser pour gérer, alimenter et auditer la mémoire persistante d'un projet — ce qui traverse les sessions sans aller dans le CLAUDE.md. --- ## Quand utiliser ce contexte - ✅ Début de projet : initialiser la mémoire avec ce qu'on sait déjà - ✅ Après une longue session productive : capturer ce qui vaut la peine de traverser les sessions - ✅ Mémoire qui a dérivé : audit et nettoyage - ✅ Onboarding sur un projet existant : comprendre ce qui est déjà mémorisé - ❌ Conserver le détail des sessions passées — le git log est plus fiable - ❌ Dupliquer ce qui est déjà dans le CLAUDE.md --- ## Section 1 : Les 4 types de mémoire ### user — qui est la personne Informations sur le rôle, le niveau technique, les domaines de connaissance. Permet d'ajuster le niveau d'explication sans re-présentation à chaque session. Exemples : - "Dev senior Go, découvre React pour ce projet — expliquer le frontend en analogies backend" - "Data scientist, première fois sur ce codebase — pas besoin d'expliquer les bases de Python" ### feedback — comment aborder le travail Guidance sur l'approche : ce qui a été corrigé, ce qui a été validé. S'applique aux sessions futures. Structure : règle → **Why:** (raison donnée) → **How to apply:** (quand ça s'applique) Exemples : - "Ne pas résumer ce qu'on vient de faire en fin de message — l'utilisateur lit le diff" - "Tests d'intégration sur vraie base de données, pas de mocks — incident en prod causé par divergence mock/réel" ### project — l'état en cours Décisions actives, initiatives, contraintes temporelles. Vieillissent vite — à revoir régulièrement. Structure : fait/décision → **Why:** (motivation) → **How to apply:** (comment ça influence les suggestions) Exemples : - "Freeze de merge à partir du 2026-03-05 — release mobile en cours" - "Réécriture du middleware auth motivée par compliance légale, pas par dette technique" ### reference — où trouver l'information Pointeurs vers des ressources externes utilisées régulièrement. Exemples : - "Bugs pipeline dans Linear project INGEST" - "Board Grafana latency : grafana.internal/d/api-latency — surveiller si on touche les request handlers" --- ## Section 2 : Critères de tri ### Ce qui mérite d'être retenu ``` ✅ Non déductible du code ou du CLAUDE.md ✅ Utile dans les prochaines sessions (pas juste aujourd'hui) ✅ Gotcha réel — contrainte invisible, comportement contre-intuitif ✅ Préférence confirmée ou corrigée en session ✅ Décision d'architecture pas encore dans le code ✅ Pointeur vers ressource externe régulièrement utile ``` ### Ce qui n'a pas sa place ``` ❌ Visible dans les fichiers — Claude le retrouvera en lisant ❌ Détail des sessions passées — git log est plus fiable ❌ Tâches en cours — appartiennent à la session, pas à la mémoire ❌ Convention déjà dans le CLAUDE.md — duplication inutile ❌ Cas limite qui ne se reproduira pas ``` ### Le test en une question > "Si je supprime ce fichier mémoire et que Claude relit le code, manquera-t-il quelque chose d'important ?" Si non → la mémoire est inutile. Si oui → elle a sa place. --- ## Section 3 : Prompt d'audit À lancer quand la mémoire a dérivé ou après une longue période sans révision. ```text Audite les fichiers mémoire dans `.claude/projects/.../memory/` (et `~/.claude/memory/` pour la mémoire globale si elle existe). Pour chaque fichier mémoire : 1. Le contenu est-il encore exact ? (vérifier contre l'état actuel des fichiers/code si nécessaire) 2. Est-il non déductible du code ou du CLAUDE.md ? 3. Le type est-il correct ? (user / feedback / project / reference) 4. La description dans le frontmatter est-elle assez précise pour décider de la pertinence sans lire le corps ? Cohérence globale : - Doublons ou contradictions entre fichiers ? - Mémoires "project" obsolètes (décisions résolues, états dépassés) ? - MEMORY.md à jour avec tous les fichiers présents ? Résultat en tableau : Fichier | Problème détecté | Action recommandée Puis applique les corrections validées. ``` --- ## Section 4 : Slash command /audit-memory Pour ne pas avoir à retrouver le prompt d'audit, le sauvegarder comme commande slash. **Mémoire projet uniquement :** Créer `.claude/commands/audit-memory.md` à la racine du projet. **Toutes sessions, tous projets :** Créer `~/.claude/commands/audit-memory.md`. Contenu du fichier : ```text Audite les fichiers mémoire dans `.claude/projects/.../memory/` (et `~/.claude/memory/` pour la mémoire globale si elle existe). Pour chaque fichier mémoire : 1. Le contenu est-il encore exact ? (vérifier contre l'état actuel des fichiers/code si nécessaire) 2. Est-il non déductible du code ou du CLAUDE.md ? 3. Le type est-il correct ? (user / feedback / project / reference) 4. La description dans le frontmatter est-elle assez précise ? Cohérence globale : doublons, contradictions, mémoires project obsolètes, MEMORY.md à jour ? Résultat en tableau : Fichier | Problème | Action recommandée Puis applique les corrections. ``` Ensuite `/audit-memory` suffit pour lancer l'audit depuis n'importe quelle session. --- ## Section 5 : Mémoire projet vs mémoire globale | | Mémoire projet | Mémoire globale | |---|---|---| | **Chemin** | `~/.claude/projects//memory/` | `~/.claude/memory/` | | **Scope** | Un seul répertoire de travail | Toutes sessions, tous projets | | **Types adaptés** | feedback projet, project, reference | user, feedback transversal | | **Priorité** | Chargée après la globale | Chargée en premier | **Règle pratique :** commencer en mémoire projet. Déplacer en global seulement si une préférence revient sur tous les projets. Ne jamais dupliquer les deux. --- ## Section 6 : Checklist d'initialisation ``` □ MEMORY.md créé (index des fichiers mémoire) □ Au moins un fichier "user" — qui est la personne, niveau technique □ Fichiers "feedback" pour les préférences déjà connues □ Fichiers "project" pour les décisions actives (avec date absolue si deadline) □ Fichiers "reference" pour les ressources externes régulières □ Chaque fichier a un frontmatter complet (name, description, type) □ La description de chaque fichier permet de juger la pertinence sans lire le corps □ /audit-memory configuré (project ou global selon usage) ``` --- *Last updated: 2026-03 — Contexte associé à l'article [Mémoire persistante dans Claude Code](https://www.web-developpeur.com/blog/memoire-auto-claude-code).*