Mneme : un accrochage PreToolUse qui bloque les modifications de Claude Code violant les décisions architecturales

Marcus Dillavou a construit Mneme, un hook PreToolUse qui intercepte les modifications de Claude Code et les vérifie par rapport à un fichier d'architecture de décisions enregistré avant qu'elles ne touchent le disque. L'objectif : empêcher les bibliothèques interdites, les motifs rejetés et les conventions oubliées de réapparaître dans de nouveaux fichiers.

Installation

pip install mneme
python scripts/install_claude_code.py

Ceci écrit l'entrée du hook dans .claude/settings.json et installe quatre commandes slash :

• /mneme-check — exécuter une vérification de violation
• /mneme-context — obtenir le contexte du fichier actuel
• /mneme-record — enregistrer une nouvelle décision
• /mneme-review — examiner les décisions existantes

Fonctionnement

Lorsque Claude tente une modification, Mneme compare l'opération avec les décisions indexées par mots-clés. Si une violation est détectée, le hook bloque l'opération et renvoie l'ID de la décision comme retour. Claude voit la restriction, comprend pourquoi, et ajuste sa sortie — aucune intervention manuelle nécessaire.

Le hook échoue ouvert : si Mneme n'est pas dans le PATH ou expire, il sort avec le code 0 et Claude Code procède normalement. Il ne bloque que lorsque mneme check renvoie effectivement un verdict de violation.

Cas particuliers

La récupération est basée sur des mots-clés, donc la portée des décisions est importante. L'auteur recherche activement des retours d'expérience concrets pour savoir si le hook se déclenche correctement dans des projets en production.