sub-agent-orchestrator

サブエージェント・オーケストレーター

各ステップが前のステップに依存する、複数エージェントのパイプラインを設計して実行します。YAML で役割、依存関係、引き継ぎを定義し、順次、並列、条件分岐、ループ、マップリデュースのワークフローを、再試行、タイムアウト、検証とともに実行します。

均質な並列コード変更を行う Agent Army や、均質な並列データ処理を行う Agent Swarm とは異なり、このオーケストレーターは、A の出力が B の入力になるような、異種のパイプラインを調整します。

目次

• references/patterns.md -- 6 つのワークフローパターンと Agent Army／Swarm との比較。
• references/workflow-schema.md -- YAML ワークフロー定義言語の全仕様。
• references/examples.md -- 一連の手順を示すワークフロー例（調査から提案まで、リードスコアリング）。
• references/execution-engine.md -- ステップごとの実行モデル、再試行、タイムアウト、検証、エッジケース。
• references/templates.md -- 再利用可能なワークフローのひな形。
• references/visual-and-reporting.md -- テキスト図と実行レポートのテンプレート。

ワークフロー

1. リクエストからモードを判定します。

   • ワークフローファイルを実行する：指定されたパスの YAML を読み込みます。
   • インラインで定義して実行する：自然言語の説明をワークフロー YAML に変換し（references/workflow-schema.md を参照）、承認のために提示します。
   • ドライラン：エージェントをデプロイせずに、解析、検証、入力の解決を行い、実行計画を提示します。
   • インスペクション：YAML を解析し、人が読める説明とテキスト図を作成します（references/visual-and-reporting.md を参照）。

2. ワークフローを解析して検証します。必須フィールドがそろっていること、エージェント ID が解決できること、循環依存がないことを確認します。構文エラーや参照エラーがある場合は、該当行とともに報告します。references/execution-engine.md を参照してください。

3. 入力を解決します。開始前に、必要な入力をすべてユーザーから収集し、任意入力にはデフォルト値を適用します。

4. 実行 DAG を構築し、対応する実行モデル（順次、並列、条件分岐、ループ、マップ）に従って、トポロジカル順序で各ステップを実行します。references/execution-engine.md を参照してください。

5. 各エージェントの完了後、エージェントのスキーマとルールに照らして出力を検証します。失敗した場合は、再試行／タイムアウト／失敗時のポリシー（スキップ、中止、フォールバック）を適用します。

6. 完了したら、references/visual-and-reporting.md の実行レポートテンプレートを使って結果を提示します。一部のみ完了した場合や実行が失敗した場合は、完了した内容、失敗した内容、および収集できた部分的な出力を報告します。

パターンの選び方

タスクの形に合ったパターンを選び、references/templates.md を使ってひな形を作成します。

• 複数の異なるステップを厳密な順序で実行する：順次チェーン。
• 1 つの入力を複数の観点からスコアリングまたは分析する：並列ファンアウト／ファンイン。
• 分類に基づいて入力を振り分ける：条件分岐ルーティング。
• 出力が品質基準を満たす必要がある：バリデーター付きループ。
• 大きな入力を分割して再統合する：マップリデュース。
• 失敗時に代替手段が必要なステップがある：フォールバック付きパイプライン。

各パターンの図と例については、references/patterns.md を参照してください。