フック
フックはアクセラレータでありガードです。プラン、コントラクト、レビュー、チェックを置き換える
ものではありません。すべてのルートは event + routeId + matcher で指定され、ガードルートは
フェイルクローズで動作します。
管理対象ルート
Section titled “管理対象ルート”| イベント | ルート | マッチャー | 動作 |
|---|---|---|---|
SessionStart | .default | すべてのセッション | 前回セッションの再開パケットを注入する |
PreToolUse | .edit 🛡 | Edit / Write | プランが承認されるまで編集を保留する |
PreToolUse | .subagent 🛡 | Task / Agent | 委任された作業の範囲を限定する |
PostToolUse | .edit | Edit / Write | アーキテクチャドリフト + コントラクトのチェック |
PostToolUse | .bash | Bash | シェルコマンドをトレースする |
PostToolUse | .always | すべてのツール | イベントトレースに追記する |
UserPromptSubmit | .default | すべてのプロンプト | 意図をルーティングし、プラン状況を表示する |
Stop | .default 🛡 | セッション停止 | 次のハンドオフパケットを書き込む |
🛡 = フェイルクローズ。
どこに存在するか
Section titled “どこに存在するか”インストール可能なソースは assets/hooks/ です。アクティブなランタイムは中央優先で解決します。
ユーザーレベルの ~/.claude/settings.json と ~/.codex/hooks.json は、各イベントをハーネスへ
ディスパッチするホストアダプタです。リポジトリローカルの .claude/hooks/ と .codex/hooks.json は
レガシーなクリーンアップ対象であり、保持されるのは自分自身の custom-*.sh フックのみです。