orchestration

オーケストレーション

概要

プロジェクトのライフサイクル全体にわたって、スキル、フレームワーク、ワークフローを調整します。パターンに基づくプロジェクト分類と、目標の分解、階層的なタスク計画、マルチエージェントの調整を組み合わせます。

プロジェクトレベルのワークフローに関する判断、つまり、どのフレームワークをどの順序で有効化するか、各フェーズの間で進捗をどのように検証するかを決める際に、このスキルを使用してください。Claude Code固有のエージェント実装の詳細（エージェント設定、バッチサイズ、プロンプトエンジニアリング）については、代わりにagent-patternsスキルを使用してください。

このスキルは、プロジェクト管理ツールの代わりにはなりません。各移行時点で、機能をどの順序で適用するかを決め、準備状況を検証するための判断フレームワークを提供します。

クイックリファレンス

必要なこと	アクション
プロジェクトの種類を特定する	パターンA／B／Cに分類する
フレームワークの順序を決める	パターンごとのフェーズ順序に従う
目標を分解する	必要な効果を抽出し、機能に対応付ける
準備状況を検証する	次に進む前にフェーズゲートの基準を確認する
代替案を見つける	ステップごとに代替機能を生成する
計画を採点する	コスト、レイテンシ、リスク、多様性を評価する
エージェントを調整する	タスクの種類に応じてオーケストレーションパターンを選択する
コンテキストを渡す	サブエージェントにはコンテキストの蒸留を使用する

パターンの特定

フレームワークやスキルを選択する前に、すべてのプロジェクトを分類してください。

パターン	特徴	期間
A：シンプルな機能	既存システム、十分に理解されている、単一チーム	1～5日
B：新規製品／システム	ゼロからの開発、セキュリティ／コンプライアンスが重要	4～12週間
C：AIネイティブ／複雑	AI エージェント、RAG、ナレッジグラフ、オーケストレーション	8～20週間

フェーズゲート

ゲートの基準を満たすまでは、次のフェーズに進まないでください。

ゲート	開始基準
設計（フェーズ2）	PRPが完成している、問題が検証済み、成功指標がある、ユーザーストーリーがある
開発（3）	アーキテクチャが文書化されている、データモデルが設計されている、セキュリティ上の脅威がマッピングされている
テスト（フェーズ4）	機能が完成している、ユニットテストのカバレッジが80％超、コードレビュー済み、SASTに問題がない
デプロイ（5）	すべてのテストに合格している、UATが完了している、セキュリティテスト済み、カバレッジが90％超

スコアリング関数

計画は、重み付き効用を使用して評価されます。

要素	重み	スコア
コスト	0.3	無料=1.0、低=0.8、中=0.5、高=0.2
リスク	0.3	安全=1.0、低=0.8、中=0.5、高=0.2
レイテンシ	0.2	即時=1.0、高速=0.7、低速=0.3
多様性	0.2	min(unique_domains / 5, 1.0)

補正：最近使用した機能（過去3ステップ以内）には-30％のペナルティが適用されます。新しい機能には+20％のボーナスが適用されます。

マルチエージェントのオーケストレーションパターン

パターン	使用例
階層型	親が専門のサブエージェントに作業を委任する
順次型	専門家をつなぐ（アーキテクト -> 開発 -> レビュー）
並列型	独立したタスクを同時に実行する
ハンドオフ型	あるエージェントがコンテキストを次のエージェントに渡す

主なルール：委任の深さは最大3とし、コードベース全体ではなくコンテキストの蒸留を使用し、エージェント間のやり取りをすべて記録してください。

MCP 統合

MCP（Model Context Protocol）は、エージェントが外部ツール、データソース、プロンプトテンプレートに接続する方法を標準化します。オーケストレーターは起動時に利用可能な MCP サーバーを検出し、サブエージェントからのツール呼び出しを適切なサーバーにルーティングします。

MCP プリミティブ	オーケストレーションにおける役割
リソース	作業前に利用可能なデータ（スキーマ、設定、ドキュメント）を検出します
ツール	型付き引数を使って検証済みのアクションを実行します
プロンプト	エージェント間でドメイン固有の指示テンプレートを再利用します
サンプリング	サーバーが実行中に AI による推論をリクエストできるようにします

よくある間違い

間違い	正しいパターン
すべてのプロジェクトをパターン A（シンプルな機能）として扱う	フレームワークを選ぶ前に分類します：パターン A（シンプル）、B（新製品）、C（AI ネイティブ）
作業を速めるためにフェーズゲートを省略する	次に進む前にゲート基準を適用します。省略すると手戻りが積み重なります
利用可能なすべてのスキルを同時に有効化する	明確な成果物と引き継ぎを定め、フェーズごとにスキルを 1～3 個に制限します
機能の選択に関する意思決定を記録しない	各ステップで、根拠、検討した代替案、スコア、却下理由を記録します
前提条件を検証せずに HTN プランを作成する	まず、ファイル、依存関係、環境変数などのプロジェクトの状態を、各機能の要件と照らし合わせます
明確な目的マニフェストなしで委任する	すべてのサブエージェントに、目的、制約、最大トークン数、利用可能なツールが必要です
コードベース全体をサブエージェントに渡す	コンテキストの蒸留を使い、関連するシンボルと事実だけを渡します

委任

• プロジェクトのパターンを特定し、スコープを分類する：Explore エージェントを使って、コードベース、依存関係、要件を調査します
• 複数フェーズのオーケストレーション計画を実行する：Task エージェントを使って、ゲート検証を行いながら、フェーズごとの成果物を実装します
• アーキテクチャと機能の実行順序を設計する：Plan エージェントを使って、目標を分解し、スコア付き HTN プランを作成します

参考資料

• goal-decomposition.md -- HTN 計画、目標分析、機能のマッチング、前提条件の検証、スコアリング、意思決定の記録
• project-patterns.md -- パターン A/B/C の分類、フェーズの順序、フェーズごとのスキル調整、並列化
• multi-agent-coordination.md -- 階層型、逐次型、並列型のオーケストレーションパターン、委任マニフェスト、再帰の上限
• mcp-orchestration.md -- MCP アーキテクチャ、リソース、ツール、プロンプト、複数サーバーのオーケストレーション、双方向サンプリング
• context-distillation.md -- シンボルのインデックス作成、事実の抽出、再帰的なコンテキスト削減、トークン管理
• error-handling.md -- 目的の逸脱、ツールの失敗、コンテキストのオーバーフロー、サーキットブレーカー、復旧戦略、ログ記録