Claude Code hooksに挿す4本の確認スクリプト入門

AIがやらかしやすいミスには法則がある。確認しないまま「完了しました」と報告する。破壊的なコマンドを実行する直前に立ち止まらない。人間からの指摘を拾い忘れる。既にあるファイルを知らずに再作成する。これらはAIの知能の問題というより、実装の瞬間の「ルーチン不備」だ。agent-guard-checks は、このパターンを4本の正規表現スクリプトで形式化し、Claude Code の hooks に差し込んで、人間が通す前に引っかかる仕組みを作る。

AIの鬼が面白いと思うのはここだ。AIを信頼するのではなく「AIはここで必ず転ぶ」と決めつけて、転び場所に踏み板を置く発想。完全な代替ではなく、人間のチェック工程そのものを早める。check_completion_claims.py は「完了を言う前に証拠を示したか」を確認し、guard_irreversible.py は「rm -rf や git push --force の直前に立ち止まらせる」。capture_correction.py は「相手が否定や不明瞭さを言ったのに、AIが聞き直さず続ける」瞬間を拾う。どれも単体CLI、ファイルも実行せず、止めるかは呼び出す側の責任。つまりAIに権限を与えず、人間が最終判断する前の「警告ライト」に徹している。

中小企業の実務では、この使い方が実は最強だ。自動化に走るのではなく、判断のバリデーション層として使う。毎回の訂正場面を分類できれば、同じパターンの事故は減る。settings.json に登録するだけで導入でき、4本目の preflight_existing.py で「そのファイル、既にありませんか」と聞く習慣まで根付く。事故や手戻りが減るかどうかは企業の運用次第だが、AIエージェント運用を人間の訂正ルーチンから始めるなら、この4本のスクリプトは必携だ。