Claude Codeのサブエージェント、7つに分けた設計基準

この記事は、Claude Codeで複数のサブエージェントを運用するリポジトリの設計を、書き始めた時点の基準と運用初日の出来事に分けて記録したものだ。前回の記事でメインセッションをPMとして固定する体制を、別の記事でサブエージェント間をファイル経由で受け渡す方式をそれぞれ書いており、今回はその前提の上で「何個に分けるか」を扱っている。

設計では7つの役割すべてで出力先が異なり、市場調査、企画、実装、執筆、検査、SEO、収益分析という評価基準の違いを根拠に分けた。descriptionの文末に「いつ使うか」を添える運用も分業の一部として扱っているが、content-writerだけはその一文がなく、メインセッションが役割表で指名する現状では実害は出ていない。toolsの絞り方も分業の一部で、qa-reviewerは書き込み権限を持たず、revenue-analystだけ軽量モデルを割り当て、builderは全ツールを継承した上でAgentだけを打ち消す逆の書き方をしている。

運用初日には、builderとcontent-writerを1セッションでまとめて代行させた例と、growth-marketerとrevenue-analystが未起動のままという例が出た。どちらも分けすぎ・分けなさすぎの判断がついていない領域であり、定義ファイルが1つで済む修正のしやすさを前提に、実際の呼ばれ方を見ながら数を調整していく方針が示されている。