execution-handoff-generator

実行引き継ぎジェネレーター

計画 → 実装をつなぎます。{product_root}/docs/versions/{version_san}/execution-handoff.md を作成し、維持します。このファイルは、タスクの順序、進捗、経過時間に関する唯一の信頼できる情報源です。

requirements.md は何をするか、tasks/task-NNN-*.md はどのようにするか、execution-handoff.md はどの順序で進めるか、そしてどこで実行が止まったかを示します。

ハーネスの確認

../nextstage-harness/references/harness-discovery.md と ../nextstage-harness/references/artifact-layout.md を参照してください。

使用するタイミング

トリガー	アクション
計画の終了時（すべての task-NNN-*.md を作成済み）	最初の引き継ぎを生成する
タスクは存在するが、引き継ぎがない	実装の前に生成する
タスクの開始、完了、ブロック、または免除時	ステータスを更新し、時間を再計算する
すべてのタスクが完了 — レビュー／リビング仕様／終了	バージョンのステータスと最終タイムスタンプを更新する

実装者の一連の作業（引き継ぎを読む → タスクサイクル → 終了）については、 references/run-implementation.md を参照してください。

前提条件（生成）

• {product_root} と {version_san} が定義されている
• {product_root}/docs/versions/{version_san}/requirements.md が存在する
• {product_root}/docs/versions/{version_san}/tasks/task-*.md が1つ以上存在する
• テンプレート：references/execution-handoff.template.md
• 計画セッションのタイムスタンプ：
  • planning_started_at（ISO ローカル時刻 YYYY-MM-DDTHH:MM:SS）
  • planning_finished_at（ISO ローカル時刻 YYYY-MM-DDTHH:MM:SS）
  • planning_total_seconds（0以上の整数）

サブバージョンの場合は、引き継ぎを subversions/{subversion_san}/execution-handoff.md に書き込みます（スライスの範囲のみ）。

初回生成

1. タスクのメタデータを収集する

各 task-NNN-*.md から、番号順に情報を収集します。

フィールド	参照元
ID	ファイル名の NNN
File	ファイル名
Title	最初の # ... 行
Feature	**Related feature:** 行
Layer	ファイル名またはタスク本文から推定（backend、frontend、infra、unit-tests、e2e）
Model tier	**Suggested model tier:** がある場合

2. 実行ルールのブロックを作成する

requirements.md と、存在する場合は {product_root}/docs/context/stack-confirmed.md を読みます。重要な項目を最大10個、{execution_rules_block} に追加します。レガシー DB の制約、マルチテナント、テスト環境のルールなどが該当します。requirements ファイル全体を重複して記載しないでください。

3. ファイルを書き込む

references/execution-handoff.template.md を使って、 {product_root}/docs/versions/{version_san}/execution-handoff.md に保存します。

• すべてのタスクのステータスを Status: pending、タイムスタンプを —、時間を Time (s): 0 にします
• {next_task_id} = 最初のタスク ID（例：001）
• {base_branch}／{work_branch} は、gitlab-sync-config.md が存在する場合はそこから取得し、それ以外の場合は —

4. オーケストレーターに報告する

引き継ぎのパス、インデックス化したタスクの総数、最初のタスク ID、および references/run-implementation.md を使って実装を開始するよう指示を返します。

実装中のステータス更新

タスクの開始、完了、ブロック、または免除時には、次の手順を実行します。

1. Task status でタスクの行を探します
2. Status、Started at（in_progress 時）、Finished at（completed 時）、Time (s)（Finished at − Started at）、Updated at、Notes を更新します
3. Progress を再計算します（Next task = 最初の pending または in_progress）
4. Time tracking (seconds) を再計算します：
   • Implementation — start = 入力済みの最も早い Started at
   • Implementation — end = 入力済みの最も遅い Finished at（存在する場合）
   • Implementation — total (s) = end − start
   • Total task time (s) = Time (s) 列の合計
   • Total process time (s) = Planning — total (s) + Implementation — total (s) +（存在する場合は Final delivery — end − Implementation — end）
   • Last recalculated = 現在のタイムスタンプ
5. Version status を更新します（テンプレートを参照）
6. 必要に応じて Session history に追記します

バージョンをクローズする際（レビュー、Living Specs、_done/ への移動）は、以下も入力します： Post-implementation review — end、Living specs — end（該当する場合）、 Final delivery — end を入力し、Total process time (s) を再計算します。

許可されるタスクステータス

pending | in_progress | completed | blocked | waived

• waived： 行の Notes に、人間による免除の記録が必要です。文書化されたリスク受容なしに、P0 テストタスク（テナント分離、URL RBAC、認証レート制限）を免除してはいけません。
• 禁止： code-review-report.md なしで、バージョンを completed にすること
• 禁止： 人間の承認なしに、タスクの順序を変更したり、ベースプロンプトを書き換えたりすること
• 禁止： セッション履歴を削除すること — 追記のみ

生成後にタスクが追加または削除された場合は、既存のステータスをタスク ID ごとに保持して再生成します。

統合

Stage	Skill / reference
タスク生成後	このスキル（引き継ぎの生成）
従来型の実装	references/run-implementation.md + code-coder
分割型の実装	execution-orchestrator（スライスの引き継ぎ + マスターのクローズ）
バージョン終了時のレビュー	code-reviewer
Living Specs	pm-living-spec-consolidator
GitLab ボードの同期	gitlab-board-sync（設定が存在する場合）

参照

File	When
references/execution-handoff.template.md	引き継ぎの構成
references/run-implementation.md	従来型のバージョン実行ループ