Structure du coffre-fort et débogage

Organise un coffre-fort markdown comme une seconde mémoire consultable. Triage les quatre modes de défaillance lorsque Claude fait quelque chose d'inattendu.

STATE.md et MEMORY.md contiennent ce dont chaque session a besoin. Un coffre-fort markdown (Obsidian ou n'importe quel dossier) contient tout le reste : notes de stratégie, transcriptions de réunions, journaux de projet, recherches, analyses concurrentielles.

Le coffre-fort se transforme en mémoire institutionnelle : les décisions que tu as prises il y a six mois et pourquoi, les documents de référence qui éclairent le travail actuel, les modèles qui s'étendent sur plusieurs projets. Connecte-le via un MCP Obsidian ou un système de fichiers et Claude peut rechercher l'ensemble à la demande. Sans le coffre-fort, cette connaissance n'existe que dans ta tête ou est enfouie dans d'anciens documents.

Pourquoi le markdown est meilleur qu'une base de données : les fichiers simples sont greppables, versionnés avec git, s'ouvrent dans n'importe quel éditeur et survivent à chaque changement d'outil. Une structure de travail :

~/notes/

├── STATE.md # Toujours chargé

├── MEMORY.md # Index, toujours chargé

├── STRATEGY-DIGEST.md # Résumés des documents de stratégie

├── strategy/ # Documents complets, lus à la demande

├── projects/ # Notes de projet datées

├── resources/

└── reference/La clé de la mise à l'échelle est le modèle de résumé : lorsque tu écris un document de stratégie de 1 000 mots, écris un résumé de 3 phrases à côté et indexe le résumé dans MEMORY.md. Claude lit environ 50 jetons au démarrage de la session au lieu des quelque 1 500 du document complet. Pour 25 documents de stratégie, cela représente 1 250 jetons contre 37 500, et les sessions restent rapides.

Lorsque Claude fait quelque chose d'inattendu, vérifie quatre modes de défaillance dans l'ordre, du plus au moins courant :

Mémoire obsolète : STATE.md dit une chose, la réalité en dit une autre. Claude a parfaitement suivi tes instructions ; les instructions étaient fausses. Demande "Montre-moi ton STATE.md" en premier, à chaque fois.

Contexte manquant : le fichier pertinent n'a jamais été chargé, donc Claude a fait une supposition raisonnable. Charge le fichier explicitement et redemande.

Outil indisponible : un MCP est en panne ou un hook a bloqué une commande, et Claude l'a mal contourné. Vérifie la disponibilité de l'outil avant de blâmer le raisonnement.

Hallucination : la cause la plus rare. Vérifie d'abord : grep la fonction, vérifie que le point de terminaison existe. La plupart des "hallucinations" s'avèrent être l'une des trois premières.

Une question de diagnostic par mode de défaillance :

Mémoire obsolète : "Que dit ton STATE.md à propos de [sujet] ?" Le contenu d'il y a trois sessions signifie un état obsolète.

Contexte manquant : "Quels fichiers as-tu chargés à propos de [sujet] ?" Aucun fichier pertinent signifie charger le bon.

Outil indisponible : "Quels outils as-tu disponibles en ce moment ?"

Hallucination : "Grep pour [fonction/point de terminaison] et montre-moi ce que tu trouves."

La séquence prend deux minutes et trouve la cause presque à chaque fois. Sauter directement à "Claude a halluciné" retarde généralement la vraie solution en réécrivant du code qui n'avait pas besoin d'être réécrit.

La prévention vaut mieux que le débogage. Les habitudes :

Mise à jour de STATE.md en fin de session. Élimine 80 % des problèmes de mémoire obsolète.

Archive les projets livrés dans des fichiers project_* datés.

Audit mensuel de MEMORY.md : confirme que chaque pointeur pointe toujours vers un fichier existant.

Résume chaque document de plus de 500 mots.

Écris les décisions au moment de la décision, pas à la fin de la semaine. La capture rétroactive perd le raisonnement.

Avant d'archiver les notes de projet, extrais les leçons durables dans des entrées feedback_*. Le projet devient de l'histoire ; les leçons restent actives.

Un coffre-fort avec 10 documents bien entretenus vaut mieux qu'un avec 200 documents obsolètes. La qualité et l'actualité l'emportent sur le volume.

Avec un MCP Obsidian ou un système de fichiers, le coffre-fort devient une base de connaissances vivante :

Archéologie des décisions : "Recherche dans le coffre-fort pourquoi nous avons choisi Postgres plutôt que MySQL." Une chasse manuelle de 10 minutes devient 15 secondes.

Détection de modèles : "Trouve toutes les mentions de problèmes de limitation de débit ou d'erreurs 429 dans les projets." Claude fait remonter une cause profonde commune répartie sur cinq fichiers de projet.

Recherche de référence : "Trouve les coordonnées dans les notes du fournisseur." Récupération instantanée à partir de fichiers non indexés.

La qualité de la recherche dépend de la cohérence du nommage : project_[nom]_[date].md et feedback_[règle].md valent mieux que ce qui semblait naturel à l'époque. Les conventions de nommage sont l'index que tu construis avant d'en avoir besoin.

Les quatre modes sont vérifiés et la sortie est toujours fausse ? Deux causes ressemblent à des hallucinations mais n'en sont pas.

Ordre du contexte : lorsque les fichiers chargés sont en conflit, le contenu chargé plus tard a tendance à l'emporter. Si d'anciennes notes de projet contredisent STATE.md, attribue explicitement l'autorité : "STATE.md est la vérité actuelle. Il remplace tout ce qui se trouve dans les notes de projet."

Collisions de contraintes : CLAUDE.md dit "paramétrer toutes les requêtes SQL", donc Claude réécrit le SQL pendant ce que tu voulais être une refactorisation de style uniquement. Ce n'est pas un bug ; délimite-le explicitement : "Style uniquement, ne modifie pas les modèles SQL."

Le diagnostic pour les deux : "Quelles instructions suis-tu qui régissent [cette décision] ? Liste les règles par ordre de priorité." Tu trouveras une source obsolète, une règle contradictoire ou une lacune dans CLAUDE.md. Tout est réparable.

Un coffre-fort markdown avec des fichiers de résumé met à l'échelle ta seconde mémoire ; les résumés maintiennent les sessions rapides, les documents complets se chargent à la demande. Lorsque Claude se comporte mal, trie dans l'ordre : mémoire obsolète, contexte manquant, outil indisponible, hallucination, et commence toujours par "montre-moi ton STATE.md". Alimente le coffre-fort au moment de la décision et sa valeur se multipliera chaque semaine.