Accueil / Le second cerveau

Mémoire fichier : structure et disciplines de base

La mémoire de Claude Code vit dans un dossier de fichiers markdown, un fait par fichier classé par un champ type à quatre valeurs, et une note qui porte une seule idée reliée à au moins une autre reste trouvable en quelques secondes plutôt qu'en une relecture complète.

Claude Code peut garder sa propre mémoire d'une session à l'autre, dans un dossier de fichiers texte au format markdown, un format simple où quelques symboles suffisent à marquer les titres et les listes. Un fichier de mémoire porte un seul fait, et son en-tête, appelé le frontmatter, porte un champ nommé type qui prend l'une de quatre valeurs possibles, listées plus bas telles que le logiciel les écrit. Un dossier de mémoire distinct existe pour chaque projet ouvert avec Claude Code, et il commence toujours par un fichier index qui recense en une ligne chacune des mémoires déjà écrites.

Le frontmatter, l'en-tête qui classe chaque fichier

Le frontmatter est le bloc d'informations placé entre deux lignes de tirets, au tout début du fichier, avant le texte que l'on lit vraiment. Il ne raconte rien, il sert seulement à ranger la note. Un fichier de mémoire minimal ressemble à ceci :

---
type: project
---
Le raccourci pour rouvrir la dernière session fermée reste actif sept jours.

Les quatre valeurs du champ type : user, feedback, project, reference

La valeur project relie une note au travail en cours sur un dépôt précis. Une note de type feedback documente au contraire un retour observé sur une façon de travailler, et une note du quatrième type listé ci-dessus signale un fait stable, à consulter plutôt qu'à suivre à la lettre.

Une note qui porte une seule idée, reliée à une autre

Le champ type sert à classer ce que Claude enregistre dans le frontmatter, mais la discipline qui rend un dossier de mémoire vraiment utile dépend entièrement de la personne qui l'écrit. Un fichier qui mélange deux faits distincts se retrouve plus difficilement le jour où un seul des deux compte encore. Une note isolée, sans aucun lien vers une autre note, reste invisible tant que personne ne pense à chercher exactement son titre.

Relier une note à au moins une autre, même par une simple phrase qui la cite, construit un réseau que l'on peut parcourir plutôt qu'une pile que l'on ne peut que fouiller de haut en bas. Cette discipline ne figure dans aucune règle imposée par le champ type : rien n'empêche d'écrire une note de type project qui mélange trois sujets sans lien vers rien d'autre. Elle reste malgré tout la différence entre un dossier consultable en quelques secondes et un dossier qu'il faut relire en entier pour retrouver un seul fait, ce que développe interroger un graphe plutôt que tout relire, la troisième leçon de ce module.

Cette même discipline explique aussi pourquoi une carte de contenu, un moyen de relier plusieurs notes entre elles, prend tout son sens une fois plusieurs fichiers de mémoire accumulés, un sujet développé dans wikilinks, cartes de contenu et types de mémoire.