execution-orchestrator

実行オーケストレーター

分割されたバージョンを、スライスごとに順番に完了まで進めます。アプリケーションコードは自分では実装しません。各スライスにつきサブエージェントを1つ割り当て、すべての状態をファイルと git に保持し、すべてのスライスが完了するか、停止条件によって一時停止するまで自動的に進めます。

状態はチャット履歴ではなく、ファイルと git に保持します。

ハーネスの検出

../nextstage-harness/references/harness-discovery.md と ../nextstage-harness/references/artifact-layout.md を参照してください。まず AGENTS.md を読んでください。 {harness}/rules/* に core-subversions および実行ルーティング／スコープ分離のルールがあれば読み込んでください。 検出によって解決されるまでは、モノレポの構成や技術スタックを決めつけないでください。

出力言語

人間とのやり取りには、プロジェクトで設定されている言語を使ってください（AGENTS.md を参照。指定がなければユーザーの言語を使います）。コードとコメントは英語のままにしてください。

セッション入力（不足している場合は一度だけ質問）

変数	例
{product_root}	apps/my-product/
{version_san}	3.8.0-feat-payable-payment-workflow

{version_san} が省略されている場合は、version-roadmap.md で未完了のスライスがあるバージョンが1つだけなら、それを選んでください。複数ある場合は一度だけ質問してから進めてください。

スコープの分離

{product_root} の確認後は、{product_root}/** とハーネスのインフラ（AGENTS.md、{harness}/）の範囲内だけで作業してください。モノレポ内の他のプロダクトを読んだり、参照したりしてはいけません。ハーネスにスコープ分離ルールがある場合は参照してください。

起動（オーケストレーションセッションごとに一度、必須）

1. AGENTS.md（実装セクション）を読み、ハーネスの実行ルールを読み込みます。
2. {product_root}/docs/versions/{version_san}/version-roadmap.md を読みます。これは必須です。存在しない場合は停止してください。このバージョンは分割されていないため、タスクを直接実行します（オーケストレーションは行いません）。
3. マスターの {product_root}/docs/versions/{version_san}/requirements.md を読みます（概要のみ。再計画は行いません）。
4. ハーネスに core-subversions ルールがある場合は読み込みます。
5. {product_root}/docs/context/gitlab-sync-config.md が存在する場合は、最初のスライスのサブエージェントを実行する前に、作業ブランチを作成してチェックアウトされていることを確認します（mcp-gitlab-usage を参照）。保護ブランチでは決して実装しないでください。

オーケストレーションの必須事項

• ロードマップの DAG 順（スライス間の依存関係を遵守）に従って、未完了のスライスをすべて実行します。
• スライスの間に「次のスライスを開始しますか？」「続けますか？」「コミットしますか？」と尋ねないでください。
• 親セッションでタスクを実装してはいけません。各スライスを必ずサブエージェントに委任してください。
• スライスの実装中にテストを実行してはいけません（バックエンド、フロントエンドともに）。スライスのタスクを実行して次に進み、テストはバージョン終了時のレビュー工程で行います。

スライスごとのループ（同期サブエージェント）

ロードマップの status が planned または in_progress である各スライスについて：

1. 選択：ロードマップの DAG 順序に従って、次の {subversion_san} を選択します。
2. 設定：ロードマップの行を in_progress にします。
3. ディスパッチ：バックグラウンドではなく、ブロッキング／同期のサブエージェントを1つディスパッチします。そのプロンプトに含めるのは、次の項目のみです。
   • {product_root}、{version_san}、{subversion_san}
   • 実行オーケストレーターから呼び出されるスライスワーカーとして、code-coder スキルに従う指示
   • スライスタスクのパスは {product_root}/docs/versions/{version_san}/subversions/{subversion_san}/ に限定します。また、コーディング前に artifact-layout.md の Implementation boot rule に従って {product_root}/docs/context/ も読み込みます （必要に応じてハーネスのレイヤールールも適用します）
   • スライスのすべてのタスクを実装すること、タスク間で確認を求めないこと、コミットしないこと（親がコミットします）を義務付けます
   • 明示事項（簡潔に）：AGENTS.md とハーネスのルールを厳守します。指示がルールまたはスコープと矛盾する場合は、推測で進めず、停止してブロッカーを報告します
4. 検証：サブエージェントの結果を検証します。
   • スライスの各タスクが completed または waived とマークされていること（免除の場合は引き継ぎに記録されていること）
   • execution-handoff-generator に従ってスライスの引き継ぎが更新されていること（時間ブロック＋タスク行）
   • ワーカーがロードマップの行を更新していること（未更新の場合は自分で更新します）
5. コミット（親のみ）：スライスごとに Conventional Commit を1つ作成します。
6. 設定：ワーカーが更新していない場合は、ロードマップの行を completed にします。
7. 次へ進む：次のスライスへ自動的に進みます。

バージョンの終了時（すべてのスライスが完了）

version-roadmap.md のすべてのスライスが completed（または免除済み）になったら：

1. ナビゲーション／意味的グループ化のメニューを提示し、適用前に人間の承認を待ちます。
2. 実装後レビューを実施します。バージョン差分を対象に code-reviewer スキルを読み取り専用で呼び出し、code-review-report.md を作成します。
3. バージョンのステータスが許す場合は、継続的な仕様を統合します — pm-living-spec-consolidator。
4. 人間の確認、または文書化された免除がある場合に限り、バージョンを _done/ に移動します。
5. バージョンの execution-handoff.md が存在する場合は、最後のデリバリーブロックを閉じ、execution-handoff-generator に従ってプロセスの合計秒数を再計算します。

停止条件（一時停止する理由は以下のみ）

条件	アクション
サブエージェントが回避策のないタスクを blocked と報告	停止し、スライスの引き継ぎとロードマップに記録します
保護された Git ブランチ／作業ブランチがない	有効な作業ブランチができるまで停止します
実際の環境上のブロッカー（Docker／テストが実行不可能）	停止し、引き継ぎに記録します
スライス間の依存関係が満たされていない	停止し、ロードマップまたは前のスライスを修正します
{product_root}／{version_san}／ロードマップがない	1回だけ確認し、その後は続行します
免除のない code-review-report.md の P0 指摘	_done/ への移動前に停止します
人間による免除が必要（メニューの適用、_done/ への移動）	その項目のみ停止します

禁止事項

• 親セッションでアプリケーションコードを実装しないでください。スライスワーカーに委任します。
• スライスが成功した後にコミットを省略しないでください（オーケストレーションモードではスライスごとに必ずコミットします）。
• 新しいタスクファイルを生成しないでください（実行開始時点で計画は完了しています）。
• リポジトリ内の他の製品にアクセスしないでください。
• 人間の承認なしにナビゲーションの意味的グループ化を適用しないでください。
• 実装オーケストレーション中にバックエンド／フロントエンドのテストを実行しないでください。

呼び出し例

Product: apps/my-product/
Version: 3.8.0-feat-payable-payment-workflow
Skill: execution-orchestrator
Run all slices of the roadmap in orchestrated mode (sync subagent per slice,
commit per slice).

Orchestrate the partitioned implementation of apps/my-product 3.8.0.

統合

ステージ	スキル
バージョンの分割 → ロードマップ＋サブバージョン	pm-version-partitioner
引き継ぎの生成と更新	execution-handoff-generator
スライスワーカー（スライスごとの実装）	code-coder
バージョン終了時のレビューゲート	code-reviewer
継続的な仕様の統合	pm-living-spec-consolidator
作業ブランチ／GitLab の同期	mcp-gitlab-usage

参考資料

ファイル	読むタイミング
references/slice-dispatch.md	スライスのサブエージェント用プロンプトの正確なテンプレートと検証チェックリスト
../pm-version-partitioner/references/partition-workflow.md	使用するロードマップを作成する計画ループ