Mneme: Ein PreToolUse-Hook, der Claude-Code-Bearbeitungen blockiert, die Architekturentscheidungen verletzen

Marcus Dillavou hat Mneme entwickelt, einen PreToolUse-Hook, der Claude Code-Bearbeitungen abfängt und sie mit einer aufgezeichneten Architekturentscheidungsdatei vergleicht, bevor sie auf die Festplatte geschrieben werden. Das Ziel: Verbotene Bibliotheken, abgelehnte Muster und vergessene Konventionen davon abhalten, in neuen Dateien wieder aufzutauchen.

Installation

pip install mneme
python scripts/install_claude_code.py

Dies schreibt den Hook-Eintrag in .claude/settings.json und installiert vier Schrägstrich-Befehle:

• /mneme-check — führt eine Verstoßprüfung durch
• /mneme-context — ruft den Kontext für die aktuelle Datei ab
• /mneme-record — zeichnet eine neue Entscheidung auf
• /mneme-review — zeigt vorhandene Entscheidungen an

Funktionsweise

Wenn Claude eine Bearbeitung versucht, vergleicht Mneme den Vorgang mit den schlagwortindizierten Entscheidungen. Wird ein Verstoß erkannt, blockiert der Hook den Vorgang und gibt die Entscheidungs-ID als Rückmeldung zurück. Claude sieht die Einschränkung, versteht den Grund und passt seine Ausgabe an — kein manueller Eingriff nötig.

Der Hook schaltet sich im Fehlerfall offen: Wenn Mneme nicht im PATH ist oder eine Zeitüberschreitung auftritt, beendet er sich mit 0 und Claude Code arbeitet normal weiter. Er blockiert nur, wenn mneme check tatsächlich einen Verstoß meldet.

Randfälle

Die Abfrage erfolgt schlagwortbasiert, daher ist der Umfang der Entscheidungen wichtig. Der Autor sucht aktiv nach Rückmeldungen aus der Praxis, ob der Hook in Produktionsprojekten korrekt auslöst.