SubagentStop の hook が、サブエージェントを使っていないメインセッションでも発火する——マルチエージェントを hook で組む人の盲点

マルチエージェントシステムにおいて、サブエージェントを使用しないメインセッションでもSubagentStopのhookが発火するという、予期せぬ挙動について解説。Claude Codeでhookを用いたサブエージェント制御を行う際の注意点を促す。

• Claude Code v2.1.186でSubagentStopフックの不具合が報告された。
• サブエージェントを使用しないメインセッション終了時にもフックが発火する。
• フックの前提条件が崩れるため、予期せぬ処理が実行される可能性がある。
• フックの入力（stdin）を記録・観察し、信頼性を確認することが推奨される。