swarm-coordination

スウォーム調整スキル

スウォーム調整スキル - エージェントの並列実行をオーケストレーションし、エージェント間のコミュニケーションを管理し、タスクの分配を処理して、複雑なマルチエージェントワークフローにおける結果の集約を調整します。 - エージェントの並列起動 - タスクの分配戦略 - 結果の集約 - エージェント間のコミュニケーション - 障害への対処と復旧

ステップ 1：タスクの並列化を分析する

並列化できる作業を特定します。

パターン	例	戦略
独立したタスク	複数ファイルのレビュー	並列で起動
依存関係のあるタスク	設計 → 実装	順次起動
ファンアウト／ファンイン	複数のレビュー → 統合	並列実行＋集約
パイプライン	解析 → 変換 → 検証	順次引き継ぎ

ステップ 2：エージェントを並列で起動する

Task ツールを使用して、1 つのメッセージ内で複数のエージェントを起動します。

// Spawn multiple agents in ONE message for parallel execution
Task({
  task_id: 'task-1',
  subagent_type: 'general-purpose',
  description: 'Architect reviewing design',
  prompt: 'Review architecture...',
});

Task({
  task_id: 'task-2',
  subagent_type: 'general-purpose',
  description: 'Security reviewing design',
  prompt: 'Review security...',
});

重要： 真の並列実行を行うには、両方の Task 呼び出しを同じメッセージ内に含める必要があります。

ステップ 3：引き継ぎ形式を定義する

エージェント間のコミュニケーションには、構造化された形式を使用します。

## Agent Handoff: [Source] → [Target]

### Context

- Task: [What was done]
- Files: [Files touched]

### Findings

- [Key finding 1]
- [Key finding 2]

### Recommendations

- [Action item 1]
- [Action item 2]

### Artifacts

- [Path to artifact 1]
- [Path to artifact 2]

ステップ 4：結果を集約する

並列で動作したエージェントの出力を統合します。

## Swarm Results Aggregation

### Participating Agents

- Architect: Completed ✅
- Security: Completed ✅
- DevOps: Completed ✅

### Consensus Points

- [Point all agents agree on]

### Conflicts

- [Point agents disagree on]
- Resolution: [How to resolve]

### Combined Recommendations

1. [Prioritized recommendation]
2. [Prioritized recommendation]

ステップ 5：障害に対処する

部分的な障害への対処方法：

シナリオ	戦略
エージェントのタイムアウト	より簡潔なプロンプトで再試行
エージェントのエラー	利用可能な結果を使って続行
結果の不一致	コンセンサス投票スキルを使用する
重要な結果の欠落	中断して再試行

</execution_process>

<best_practices>

1. 積極的に並列化する：独立した作業は並列で実行します
2. 引き継ぎを構造化する：コミュニケーションには一貫した形式を使用します
3. 適切に機能を縮退させる：安全な場合は部分的な結果を使って続行します
4. 明確に集約する：結果を体系的に統合します
5. 出所を追跡する：各結果を生成したエージェントを把握します

</best_practices>

**並列レビューの依頼**：

Get architecture, security, and performance reviews for the new API design

スウォーム調整：

// Spawn 3 reviewers in parallel (single message)
Task({ task_id: 'task-3', description: 'Architect reviewing API', prompt: '...' });
Task({ task_id: 'task-4', description: 'Security reviewing API', prompt: '...' });
Task({ task_id: 'task-5', description: 'Performance reviewing API', prompt: '...' });

集約された結果：

## API Design Review (3 agents)

### Consensus

- RESTful design is appropriate
- Need authentication on all endpoints

### Recommendations by Priority

1. [HIGH] Add rate limiting (Security)
2. [HIGH] Use connection pooling (Performance)
3. [MED] Add versioning to URLs (Architect)

</usage_example>

ルール

• 独立したエージェントは必ず並列で起動します
• 構造化された引き継ぎ形式を使用します
• 部分的な障害には適切に対処します

関連ワークフロー

このスキルには、複雑なマルチエージェントのシナリオに対応するワークフローがあります。

• ワークフロー：.claude/workflows/enterprise/swarm-coordination-skill-workflow.md
• ワークフローを使用する場合：Queen／Worker トポロジー、フォールトトレランス、分散調整を伴う大規模な並列タスク実行の場合（大規模なリファクタリング、並列コードレビュー、複数ファイルの実装）
• スキルを直接使用する場合：単純なエージェントの並列起動や、他のワークフローへのスウォームパターンの統合の場合

ワークフローとの統合

このスキルは、フレームワーク全体のマルチエージェント・オーケストレーションパターンを支えます。

ルーターの判断： .claude/workflows/core/router-decision.md

• ルーターはエージェントの並列起動にスウォームパターンを使用します
• 計画オーケストレーションマトリックスに、スウォーム調整を使用するタイミングを定義しています

アーティファクトのライフサイクル： .claude/workflows/core/skill-lifecycle.md

• スウォームパターンは、大規模なアーティファクト作成に適用されます
• 複数のアーティファクトを並列で検証します

関連ワークフロー：

• エージェントの出力の不一致を解決する consensus-voting スキル
• 並列結果を集約する context-compressor スキル
• .claude/workflows/enterprise/ 内のエンタープライズワークフローでは、スウォームパターンを使用します

---

鉄の掟

1. 絶対にワーカーを逐次起動しないでください。独立したエージェントはすべて、1つのメッセージで起動する必要があります
2. 必ず失敗検出を実装してください。ハングしたワーカーによってスウォーム全体が無期限にブロックされないようにしてください
3. 絶対にワーカー間の通信を許可しないでください。すべての調整はクイーンを通じて行う必要があります
4. 必ず構造化された引き継ぎ形式でワーカーのレポートを作成し、プログラムによる集約を可能にしてください
5. 絶対に1回のファンアウトで7人を超えるワーカーを起動しないでください。7人を超えると、調整のオーバーヘッドが大きくなります

アンチパターン

アンチパターン	失敗する理由	正しい方法
逐次起動	並列処理にならず、スウォームがキューのように実行されます	独立したワーカーをすべて1つのメッセージで起動します
ワーカー間の通信	O(N²)の調整の混乱を招きます	ワーカー間の通信はすべてクイーンを通じて行います
失敗処理がない	1つのワーカーのクラッシュでスウォームが停止します	ハングまたは失敗したワーカーを検出し、新しい状態で再起動します
無制限の並列処理	7人を超えると、調整のオーバーヘッドが高速化の効果を上回ります	最適なスループットを得るため、1回のファンアウトにつき5～7人に制限します
自由形式のワーカーレポート	プログラムで結果を集約できません	すべてのワーカーに構造化された引き継ぎテンプレートの使用を求めます

メモリプロトコル（必須）

開始前：

cat .claude/context/memory/learnings.md

完了後：

• 新しいパターン -> .claude/context/memory/learnings.md
• 発見した問題 -> .claude/context/memory/issues.md
• 決定事項 -> .claude/context/memory/decisions.md

中断されることを前提にしてください。コンテキストがリセットされる場合があります。メモリに記録されていなければ、実行されていないものとして扱います。