#サブエージェント

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

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

複数の Claude Code に開発を分担させたいとき、サブエージェントと Agent Teams は何が違うのか。セットアップ手順からチーム作成、並列実行、コスト最適化の判断基準までコード例で解説します。