クロードコードフックはAIコーディングワークフローにおけるWIP（仕掛かり作業）の蓄積を監視します

AIコーディングワークフローにおけるWIPの監視

開発者がClaude Code用のUserPromptSubmitフックを作成し、AI支援開発における一般的な問題に対処しました：AIエージェントは蓄積する進行中の作業（WIP）を可視化できません。AIが現在のプロンプトに集中している間に、未コミットの変更が増加し、コミットがプッシュされずに積み上がり、変更セットが作成されず、リリースPRが長期間開かれたままになる可能性があります。

フックの仕組み

このフックは、エディターと本番環境の間でコードが蓄積する異なるポイントを監視する4つのチェックを実装しています：

• チェック1： 200行を超える未コミットの変更（追跡済みと未追跡の両方）
• チェック2： 3つ以上の未プッシュコミット
• チェック3： 変更セットファイルのないプッシュ済みコミット（リリースPRの作成を妨げる）
• チェック4： 24時間以上開かれているリリースPR

チェック1と2はgitコマンドを使用してローカルで実行され、すべてのプロンプト送信時に実行されるため、ほぼ即時のフィードバックを提供します。チェック3と4はGitHub API呼び出しが必要なため、各プッシュ操作後に1回実行されます。

設計思想

重要な設計上の決定は、これらをゲートではなくナッジとして実装することでした。このフックはAIの作業をブロックせず、代わりに2つのチャネルを通じて可視性を提供します：

• AIのコンテキストに注入されるadditionalContext
• ユーザーのターミナルに表示されるsystemMessage

このアプローチはpermissionDecisionコンポーネントが存在しないことを意味します - AIと開発者の両方が、コーディングプロセスを中断することなくワークフローの現在の状態を確認できます。

この種のツールは、AI支援開発ワークフローのより良い監視を維持したい開発者、特にWIPが気付かれずに蓄積しやすい大規模プロジェクトで作業する場合に有用です。