Git pre-commitフックは、AIコーディングエージェントが古いドキュメントでコミットするのを防ぎます。

問題: AIコーディングエージェントが古いドキュメントでコードをコミットする

Claude CodeなどのAIコーディングアシスタントを複数セッションにわたって使用する際、開発者は特定の問題に直面します：AIがコード変更（ルートの追加、コンポーネントのリファクタリング、名前の変更など）を行いますが、ARCHITECTURE.mdやREADMEなどのドキュメントファイルを更新しません。これにより、後続のセッションではAIが数週間前のコードを記述したドキュメントを読むことから始まってしまいます。

その結果として：

• Claudeが存在しない関数名をでっち上げる
• 名前が変更されたAPIエンドポイントを参照する
• 現在のアーキテクチャと矛盾するパターンを提案する

警告は機能しません。Claudeがコミットする際、誰もstderr出力を見ていないからです。

解決策: ブロックするpre-commitフック

開発者は以下のワークフローを持つGit pre-commitフックを作成しました：

• フックは、どのファイル変更がドキュメント更新をトリガーすべきかを知っています（プロジェクトごとに設定可能なパターン）
• Claude Codeがコミットする際、フックは環境変数を介してそれを検出します
• フックはドキュメントの自動修正を試みません（Claude内からClaudeを生成するデッドロックを引き起こすため）
• 代わりに、コード1で終了し、明確なメッセージを表示します：「ドキュメントが古いです、これらのファイルを更新してから再試行してください」
• Claudeはエラーを読み取り、ドキュメントを更新し、コミットを再試行し、コミットが通ります

人間によるコミットの場合、フックはAnthropic APIを直接呼び出し、関連するセクションを修正します（約20秒かかります）。

すべてのコミットは、最近の活動の要約を含むsession-context.mdファイルを生成し、次のセッションが連続性を持てるようにします。

実装の詳細

このツールはnpmパッケージとして利用可能です：@mossrussell/agent-guard

主な特徴：

• Claude Code、Cursor、Windsurf、Copilotで動作します
• 依存関係ゼロ
• 入手先：https://www.npmjs.com/package/@mossrussell/agent-guard