Mneme: アーキテクチャ上の決定に違反するClaude Code編集をブロックするPreToolUseフック

Marcus Dillavou氏がMnemeを構築しました。これはPreToolUseフックで、Claude Codeの編集を横取りし、ディスクに書き込む前に記録されたアーキテクチャ決定ファイルと照合します。目的は、禁止されたライブラリ、拒否されたパターン、忘れられた慣例が新しいファイルに再び現れるのを防ぐことです。

インストール

pip install mneme
python scripts/install_claude_code.py

これにより、フックエントリが.claude/settings.jsonに書き込まれ、4つのスラッシュコマンドがインストールされます。

• /mneme-check — 違反チェックを実行
• /mneme-context — 現在のファイルのコンテキストを取得
• /mneme-record — 新しい決定を記録
• /mneme-review — 既存の決定をレビュー

仕組み

Claudeが編集を試みると、Mnemeは操作をキーワードインデックス化された決定と比較します。違反が検出された場合、フックは操作をブロックし、決定IDをフィードバックとして返します。Claudeは制限を認識し、その理由を理解して出力を調整します。手動によるオーバーライドは不要です。

フックはフェイルオープンです。MnemeがPATHにないかタイムアウトした場合、終了コード0で抜け、Claude Codeは通常通り動作します。ブロックが発生するのは、mneme checkが実際に違反判定を返した場合のみです。

エッジケース

検索はキーワードベースであるため、決定の範囲が重要です。作者は、プロダクションプロジェクトでフックが正しく作動するかどうか、実際のフィードバックを積極的に求めています。