parallel-agents

並列エージェントのオーケストレーション

複数のエージェントを並列で起動するときは、コンテキストの肥大化を防ぐため、次のパターンに従ってください。

基本原則

1. TaskOutput を呼び出さない - TaskOutput はエージェントの出力全体を返すため、コンテキストが肥大化します
2. バックグラウンドで実行する - 常に run_in_background: true を使用します
3. ファイルで確認する - エージェントは戻り値ではなく、ファイルにステータスを書き込みます
4. 上書きせず追記する - 複数のエージェントが同じステータスファイルに書き込めます

出力パターン

シンプルな完了確認（並列バッチ作業）

エージェントが完了を確認するだけでよいタスクの場合：

# Agent writes to shared status file
echo "COMPLETE: <task-name> - $(date)" >> .claude/cache/<batch-name>-status.txt

• 上書きする > ではなく、追記する >> を使用します
• 順序を確認できるようにタイムスタンプを含めます
• エージェントの完了ごとに1行記録します
• 次のコマンドで確認します：cat .claude/cache/<batch-name>-status.txt

詳細な出力（調査／探索）

詳細な調査結果が必要なタスクの場合：

.claude/cache/agents/<task-type>/<agent-id>/
├── output.md      # Main findings
├── artifacts/     # Any generated files
└── status.txt     # Completion confirmation

• 各エージェントに専用のディレクトリを割り当てます
• 後で読み返せるよう、出力全体を保存します
• 完了状況をすばやく確認できるよう、ステータスファイルも引き続き使用します

タスクプロンプトのテンプレート

# Task: <TASK_NAME>

## Your Mission
<clear objective>

## Output
When done, write confirmation:
\`\`\`bash
echo "COMPLETE: <identifier> - $(date)" >> .claude/cache/<batch>-status.txt
\`\`\`

Do NOT return large output. Complete work silently.

起動パターン

// Launch all in single message block (parallel)
Task({
  description: "Task 1",
  prompt: "...",
  subagent_type: "general-purpose",
  run_in_background: true
})
Task({
  description: "Task 2",
  prompt: "...",
  subagent_type: "general-purpose",
  run_in_background: true
})
// ... up to 15 parallel agents

監視

# Check completion status
cat .claude/cache/<batch>-status.txt

# Count completions
wc -l .claude/cache/<batch>-status.txt

# Watch for updates
tail -f .claude/cache/<batch>-status.txt

バッチサイズ

• 並列バッチあたりのエージェントは最大15体
• 次のバッチを起動する前に、現在のバッチの完了を待ちます
• ステータスファイルを使って、完了したエージェントを追跡します

実施すること

• 常に run_in_background: true を使用する
• エージェントにステータスファイルへの書き込みを指示する
• 上書きする > ではなく、追記する >> を使用する
• 各エージェントに明確で自己完結した指示を与える
• プロンプトに必要なコンテキストをすべて含める（エージェント間でメモリは共有されません）

避けること

• TaskOutput を呼び出す（コンテキストが肥大化します）
• エージェントから大量の出力を返す
• 一度に15体を超えるエージェントを起動する
• オーケストレーションでエージェントの戻り値に依存する

例：プロバイダーのバックフィル

# Status file
.claude/cache/provider-backfill-status.txt

# Each agent appends on completion
echo "COMPLETE: anthropic - Thu Jan 2 12:34:56 2025" >> .claude/cache/provider-backfill-status.txt
echo "COMPLETE: openai - Thu Jan 2 12:35:12 2025" >> .claude/cache/provider-backfill-status.txt

進捗を確認します：

cat .claude/cache/provider-backfill-status.txt
# COMPLETE: anthropic - Thu Jan 2 12:34:56 2025
# COMPLETE: openai - Thu Jan 2 12:35:12 2025