#サブエージェント

「並列で走らせたはずのsubagentのコミットが、なぜか中身が混ざっている」——そんな時のための記事。原因はgit worktreeの共有によるHEAD競合。isolationか直列化か、判断基準を整理した。

サブエージェントに軽い整形作業を任せただけなのに妙に時間がかかる。原因は指定し忘れたeffort設定が親セッションの重い設定を引き継いでいたことだった。継承の仕組みと機械的に弾くガードの作り方を解説する。

Agent Teamsは、独立した複数のClaude Codeがチームメイトとして直接やり取りしながら並走する実験的機能。有効化の環境変数、サブエージェントとの違い、コストを抑えるPlan→Executeの判断基準まで、実際に回した構成をコード付きで解説します。