エージェントチームで大規模タスクを並列遂行する

症状・対象

独立タスクだけでなく、「調査後に実装」「実装後に統合検証」のような依存関係を持つ作業を複数 agent で進めたい人が対象です。Claude Code の dynamic workflow へ、担当範囲と完了条件を明示します。

最短解決

1. /config で Dynamic workflow size の方針を確認する。
2. タスク、依存関係、編集範囲、検証コマンドを一つの依頼に書く。
3. lead に統合責任を持たせ、各 agent の自己申告ではなく最終コマンドで判定する。

コピペ例

次の dynamic workflow を作って実行して。

目的: 認証 API の入力検証を統一する。

タスク:
- research: src/auth/** の既存 schema と呼び出し元を調査。読み取り専用。
- tests: tests/auth/** に失敗する境界値テストを追加。research 完了後に開始。
- implementation: src/auth/** だけを修正。research と tests 完了後に開始。
- verification: 差分を独立レビューし、指定の test・type check・lint を実行。最後に開始。

境界:
- 同じファイルを複数担当が同時編集しない。
- 外部送信、push、依存追加は行わない。
- 各担当は変更ファイル、実行コマンド、結果、懸念を返す。
- lead は実ファイルを確認し、verification が通るまで完了扱いにしない。

表示を明示する場合は .claude/settings.json の既存設定へ teammateMode をマージできます。

{
  "teammateMode": "in-process"
}

期待結果

• workflow 画面で task の待機・実行・完了状態が見える。
• 依存 task は前提 task の完了後に開始する。
• lead の最終報告に変更一覧と検証結果が含まれる。

検証

workflow 完了後、親の checkout で差分と検証を再確認します。

git status --short
git diff --check

続けて、依頼に書いた test・type check・lint を親環境で実行します。agent の報告と結果が一致して初めて完了です。

落とし穴

• 未検証の実験用環境変数や内部 tool 名を手動設定しません。現行の /config と workflow UI を入口にします。
• agent から lead へのメッセージはユーザー承認ではありません。公開・削除・外部送信の権限は広がりません。
• ファイル境界だけでなく DB、port、生成物などの共有状態も分離します。
• OMC の /team は別のオーケストレーションです。混在させる前に、どちらが task ownership を持つか一つに決めます。

次の一手

• OMC の Team Pipeline でステージド実行する — OMC を coordinator にする場合の流れ
• Worktree で並行作業を安全に行う — 書き込み担当の作業領域を分離する