Accueil / Une installation structurée

Brancher la mémoire de fichiers sur git

Un dossier de mémoire versionné par git, avec un remote privé et une règle de fusion qui conserve les deux contenus plutôt que de forcer, reste une technique à construire soi même, distincte de la mémoire automatique native qui, elle, ne quitte jamais la machine locale.

Un dossier de mémoire reste un tas de fichiers texte tant qu'il vit seul sur un poste : il disparaît avec la machine, et rien ne permet de savoir qui a écrit quoi ni quand. Le transformer en dépôt git change sa nature. Ajoutez un remote privé, et ce dossier devient un coffre synchronisable entre plusieurs postes, avec l'historique, le diff et la possibilité de revenir à une version antérieure que git apporte déjà.

Le protocole en quatre gestes

Le protocole tient en peu de mots. Au démarrage d'une session, tirez les notes distantes par un pull avant de lire quoi que ce soit d'autre. Écrivez ensuite pendant la session, comme un carnet ordinaire. En fin de session, validez les notes du jour par un commit, puis poussez vers le remote. Sur un conflit de fusion, la règle n'est jamais de forcer une version sur l'autre : elle est de conserver les deux contenus et de les fusionner à la lecture, à la main, un peu plus tard. Un dépôt jetable illustre la mécanique de base sans toucher à aucun dossier réel.

mkdir demo-memoire && cd demo-memoire
git init -q
echo "note du jour" > carnet.md
git add carnet.md
git commit -q -m "premiere note"
git log --oneline

Sur un vrai coffre, cette séquence se répète à chaque session, avec un pull ajouté avant l'écriture et un push après le commit. Un dossier passé au grep pour repérer un secret avant le tout premier push évite qu'un identifiant oublié parte sur le remote et y reste ensuite dans l'historique, même après une suppression ultérieure du fichier.

Ce que la mémoire automatique native ne remplace pas

Claude Code embarque désormais un mécanisme de mémoire automatique, distinct de CLAUDE.md, qui accumule seul des notes de session dans un dossier local. Ce mécanisme reste volontairement local à la machine : les worktrees et sous dossiers d'un même dépôt git partagent un seul dossier de mémoire automatique, mais rien n'est partagé entre plusieurs machines ou environnements cloud. Le protocole git décrit ici garde donc sa raison d'être précisément là où la mémoire automatique s'arrête, dès qu'un second poste ou un remote partagé entre en jeu. Les deux mécanismes répondent à deux besoins différents et peuvent coexister sans se gêner l'un l'autre.

Ce protocole prend tout son sens une fois relié aux événements du cycle de session, dans hooks et battement de coeur, où le pull et le push cessent d'être un geste manuel pour devenir automatiques.