マルチエージェント・オーケストレーション
複数の Claude Code インスタンスを協調させて、大規模な開発タスクに取り組む方法を学びます。
サブエージェントの活用
サブエージェントは、メインの Claude が専門的なタスクを別の AI に委託する仕組みです。
ビルトインサブエージェント
| エージェント | 役割 | モード |
|---|---|---|
| Explore | コードベースの調査・探索 | 読み取り専用 |
| Plan | 設計・計画の立案 | 読み取り専用 |
| 汎用 | 並列タスクの実行 | フルアクセス |
多くの場合、Claude が自動的にサブエージェントを呼び出します。「調査してから実装して」のように指示すると、Explore エージェントが活用されやすくなります。
カスタムサブエージェント
.claude/agents/ にマークダウンファイルを配置して定義します。
markdown
---
name: reviewer
description: コードレビューを行う専門エージェント
tools:
- Read
- Glob
- Grep
---
あなたはコードレビューの専門家です。
以下の観点でコードをレビューしてください:
1. バグの可能性
2. セキュリティの問題
3. パフォーマンスの問題呼び出し方:
> /agents:reviewer src/services/auth.ts をレビューしてくださいエージェントチームの構成
複数の Claude インスタンスが対等に協力してタスクに取り組む構成です。
チームリード ←→ チームメイト A（フロントエンド）
←→ チームメイト B（バックエンド）
←→ チームメイト C（テスト）始め方
> この機能を複数のエージェントで並列に開発してください。
> フロントエンドとバックエンドを分担して実装してください。Claude がタスクの性質を判断し、必要に応じてチームメイトを生成します。各チームメイトは専用の Worktree で独立して作業します。
本番ワークフローの設計
フェーズ分割
Phase 1: Plan エージェントが設計（分析フェーズ）
Phase 2: チームメイトが並列実装（実装フェーズ）
Phase 3: レビューエージェントが品質確認（検証フェーズ）
Phase 4: リーダーが統合・最終確認（統合フェーズ）実践例: フルスタック機能開発
# Phase 1: 設計
> ユーザーダッシュボード機能の設計をしてください。
> Plan モードで要件を分析し、タスクを分解してください。
# Phase 2: 実装
> 設計に基づいて以下の分担で実装してください:
> - チームメイト1: React でダッシュボード画面
> - チームメイト2: REST API
> - チームメイト3: データベースマイグレーション
# Phase 3: 品質保証
> 実装したコードに対してテスト作成、セキュリティレビュー、
> パフォーマンス確認を実行してください。
# Phase 4: 統合
> すべての変更を統合し、最終確認を行ってから PR を作成してください。大規模プロジェクトでの運用
ベストプラクティス
| ポイント | 説明 |
|---|---|
| タスクの独立性を確保 | 各タスクがなるべく独立していること |
| 明確な分担 | ファイルやディレクトリの担当を明確にしてコンフリクトを避ける |
| インターフェースを先に決める | フロント・バック分担時は API 仕様を先に決定 |
| フェーズを分ける | 設計 → 実装 → 検証 → 統合 |
| 段階的に導入 | まず 2 エージェントから始めて徐々に拡大 |
トラブルシューティング
| 問題 | 対処法 |
|---|---|
| エージェント間でコンフリクト | ファイルの担当を明確に分ける |
| タスクの重複 | タスクリストで担当を明記 |
| 品質のバラつき | レビューフェーズを追加 |
| 長時間の処理 | タスクを小さく分割 |
注意事項
- 同じファイルを複数エージェントが同時に編集するとコンフリクトが起きる可能性がある
- バグ同士に依存関係がないことを確認する
- 修正後は統合テストで相互影響がないことを確認する
もっと詳しく知りたい方へ