Correction du gonflement du contexte dans la mémoire automatique de Claude Code à l'aide d'un schéma de nommage et d'un script d'audit

Un développeur sur r/ClaudeAI a partagé une compétence pratique qui corrige la dérive mémoire et le gonflement du contexte dans la mémoire automatique de Claude Code après des mois d'utilisation. La compétence impose un nommage des fichiers, des champs de frontmatter obligatoires et inclut un script d'audit bash pour détecter les problèmes.

Ce que fait la compétence

La mémoire automatique de Claude Code (v2.1.59+) écrit du markdown brut dans ~/.claude/projects/<slug>/memory/. La compétence ajoute une structure par-dessus : les fichiers suivent le nommage <type>_<sujet>.md, nécessitent name, description, type dans le frontmatter, et les entrées de feedback doivent inclure une section Why. La mémoire automatique continue d'écrire ; la compétence fait écrire Claude selon les spécifications.

Fonctionnalités clés

• Revue déclenchée par phrase : Dites « Audit memory » pour exécuter le script d'audit ; « Review session » parcourt la session récente et suggère quoi garder.
• Avertissement doux : L'audit signale la dérive mais ne bloque pas les écritures.
• Markdown brut : Les fichiers restent modifiables avec grep, git, etc. Pas de base de données ni de démon.

Effet sur la mémoire

Un sujet par fichier signifie que Claude tombe sur la bonne entrée dès la première recherche. Une bibliothèque dédupliquée charge moins de fichiers par session, libérant du contexte pour le travail lui-même.

Exemple de sortie d'audit

Audit mémoire · 2026-05-15 · 132 fichiers
Vérifications strictes (doivent être nulles) :
  frontmatter manquant       0
  champs frontmatter         0
  feedback sans Why          1
  violations de nommage      0
  liens MEMORY.md cassés     0
Signaux faibles :
  fichiers trop volumineux   78
  groupes de plus de 15 entrées 3
  non touchés depuis 30+ jours 31
  pas dans MEMORY.md         0
Conformité stricte : 99,2 % (1 violation / 132 fichiers)

Installation

Collez dans n'importe quelle session Claude Code : Installez la compétence claude-memory-manager depuis https://github.com/jau123/claude-memory-manager. Ensuite, dites « audit memory » pour vérifier.

Comparaison avec la mémoire automatique intégrée

• Mémoire automatique seule : Pas de schéma, pas d'audit. Claude décide du nommage et de la structure.
• Avec cette compétence : Schéma à 3 types + champs obligatoires + Why sur le feedback + script d'audit en une commande.

Limites

• Portée mono-projet uniquement.
• Pas de classement sémantique — l'audit n'est que de la correspondance de motifs.
• Script bash ; Windows/git-bash non testé.
• Excessif pour les petites bibliothèques (moins d'environ 10 entrées ou 1 mois).