ns-execution-orchestrator

実行オーケストレーター

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

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

ハーネスの検出

../ns-harness/references/harness-discovery.md と ../ns-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つディスパッチします（ブロッキング／同期。バックグラウンドでは実行しません）。 必ず、利用可能な場合はハーネスの coder-agent を使用します（../ns-harness/references/subagent-dispatch.md を参照）。利用できない場合は、ns-code-coder に従うプロンプトを使用する汎用サブエージェントを使います。プロンプトには以下のみを含めます。
   • {product_root}、{version_san}、{subversion_san}
   • 実行オーケストレーターから呼び出されるスライス作業者として ns-code-coder スキルに従う指示（coder-agent を使用する場合、ブリッジはすでにスキルを参照しています）
   • パスはスライスタスクについては {product_root}/docs/versions/{version_san}/subversions/{subversion_san}/ に限定します。また、コーディング前に artifact-layout.md の Implementation boot rule に従って {product_root}/docs/context/ も読み込みます （必要に応じてハーネスのレイヤールールも適用します）
   • 必須事項：スライスのすべてのタスクを実装し、タスク間で確認を求めず、コミットしない（親がコミットします）
   • 明示事項：スライスの実行中にテストを実行しないこと。実装のみ行います
   • 簡潔な再確認：AGENTS.md とハーネスのルールを厳守します。指示がルールまたはスコープと矛盾する場合は、推測で進めず、停止してブロッカーを報告します
4. 検証：サブエージェントの結果を検証します（単体テスト／統合テストのみ。スライスの実行中に E2E を実行することは決してありません。E2E はバージョン終了時に人間が実行します）。
   • スライスのすべてのタスクが completed または waived になっている（免除の場合は引き継ぎに記載）
   • ns-sdd-execution-handoff-generator に従ってスライスの引き継ぎが更新されている（時間ブロック＋タスク行）
   • 作業者がロードマップの行を更新している（または自分で更新します）
5. コミット（親のみ）：スライスごとに Conventional Commit を1つ作成します。
6. 設定：作業者が更新していない場合は、ロードマップの行を completed にします。
7. 次へ進む：次のスライスに自動的に進みます。

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

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

1. ナビゲーション／意味上のグループ分けメニューを提示し、適用前に人間の承認を待ちます。
2. 実装後レビューを実行します。利用可能な場合は、必ずバージョンの差分に対して reviewer-agent をディスパッチします（利用できない場合は、読み取り専用の ns-code-reviewer を使用します）。code-review-report.md は期待しないでください。却下の場合は、判定行と最小限の修正マップを使用します。 ../ns-harness/references/subagent-dispatch.md を参照してください。
3. レビューが Approved の場合、ns-sdd-living-spec-consolidator で更新が継続する仕様を統合します。
4. 人間の確認があるか、文書化された免除が存在する場合に限り、バージョンを _done/ に移動します。
5. バージョンの execution-handoff.md が存在する場合は、最終納品ブロックを閉じ、ns-sdd-execution-handoff-generator に従ってプロセス全体の秒数を再計算します。

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

条件	対応
サブエージェントが回避策のないタスク blocked を報告	停止し、スライスの引き継ぎとロードマップに記録
保護された git ブランチ／作業ブランチがない	有効な作業ブランチができるまで停止する
実環境のブロッカー（Docker／テストを実行できない）	停止し、引き継ぎに記録する
スライス間の依存関係が満たされていない	停止し、ロードマップまたは前のスライスを修正する
{product_root}／{version_san}／ロードマップがない	1回だけ確認し、その後は進める
免除なしで Code Review: Rejected／Blocked	_done/ への移動前に停止し、修正マップを適用する
人間による免除が必要（メニューの適用、_done/ への移動）	その項目についてのみ停止する

禁止事項

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

呼び出し例

Product: apps/my-product/
Version: 3.8.0-feat-payable-payment-workflow
Skill: ns-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.

連携

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

参考資料

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