Claude CodeでSubagentとWorktreeを組織化する方法

【結論】Subagent・Agent Team・WorktreeでTaskを組織化

Taskの組織化には、Main Agentから独立Contextで調査するSubagent、相互通信するAgent Team、独立作業用Worktreeを目的別に使います。

ShellでClaude Processを無制限に複製する方法は、競合、課金、Rate limitの管理が難しいため標準手段にしません。

# ターミナルで作業状態を確認
git status --short
# Claude Codeを起動
claude

具体的な手順・設定方法

1. 調査だけならSubagentへ委任し、結果の要約をMain Contextへ戻します。

2. 並行実装では担当範囲を分け、各Sessionを別Worktreeに置きます。

3. 共有Task list、Acceptance criteria、統合順序を先に決めます。

# ターミナルで独立Worktreeを作成
git worktree add ../my-app-api -b feat/api
# 起動後のセッション内でAgent一覧を確認
/agents

実践プロンプト / 活用テクニック

TaskはFile数ではなく、依存関係と検証可能な成果物で分割します。

Security review、Test設計、Docs生成は独立しやすいSubtaskです。

この変更を、API実装、UI実装、Security review、統合Testに分解してください。
各Taskの入力、成果物、担当範囲、依存関係、完了条件を示してください。
同じFileを複数担当が編集しない構成にしてください。

注意点・よくあるエラーと対処法

Subagentは同一Session内の補助役であり、Agent Teamとは通信構造が異なります。

並行化すると必ず速くなるわけではなく、統合Costが増える場合があります。

同一Fileを同時編集させず、WorktreeごとのTestとHuman reviewを通してから統合してください。