スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164

依頼（原文）

この課題には利用者が書いた文が無い。本文と追記はどれも AI が書いた（書き手の判定は各引用の下）。利用者の指示の原文として扱う文は無く、下の受け入れ条件は承認ゲート 1 で利用者が確かめる。

スプリントのプランは、作った時点の版数（開発版 10.23.0-dev.1・本番 10.23.0）を配布と本番のプランへ書き込む。プランを作ってから配布するまでの間に、並行する別のスプリントが同じ版数を本番へ出すと、そのプランの配布と本番のプランは使えなくなる。

• スプリント m2087（agy 1.4.2 が NDF のエージェント定義 8 本の model（sonnet / opus）を拒み、agy の利用者に読み込まれず pre-push も落ちる #2087・pace: normal の昇格で、承認ゲート 2 で見た先端と promote-approved がマージする先端を照合しない #2104・merged-steps.py promote の --help が、照合が食い違ったときに承認ゲート 2 へ戻ることを書いていない（#1529 の条件 9） #2142）は 2026-10-25 に /work/ai-plugins/.ndf/tmp/sprint-m2087/sprint.json を作り、7-release.json・9-release-prod.json が 10.23.0 を持った
• その後、chrome-cdp（PR Add: 利用者の Chrome を開発コンテナから CDP で操作する Skill chrome-cdp を足す #2153）が 10.23.0 として本番へ出た
• 2026-10-29、conductor は 10.23.0 の scripts でプランを作り直した（/work/ai-plugins/.ndf/tmp/sprint-m2087b/sprint.json、開発版 10.24.0-dev.1）。作り直しの間、キューは進まなかった
• 古いプランのまま流したときに、配布の工程が版数の衝突を検出して止まるのか、そのまま進むのかは確かめていない

（「どこで見つけたか」「なぜこの変更の範囲外なのか」「直さないと何が起きるか」「由来: PR #2160」の節は略さず課題の起票時の本文にある）

（書き手: 起票者（スプリント m2087 の振り返りで範囲外の課題として起票した AI）、日付: 2026-10-29 ごろ。根拠: 本文が out-of-scope の節の形で、「由来 PR #2160」を持つ）

再発（2026-10-31、スプリント m26-1）

• 別のスプリント m1426 が並行して develop へ入り、先に v10.27.1 まで本番へ出した。m26-1 のスプリント PR スプリント m26-1 #2268 は版の行で衝突し、conductor が版を 10.27.0 → 10.27.2 へ書き換えて流し直した（本番 PR Release: ndf v10.27.2 #2281 ・ Release: ndf v10.27.2 を main へ #2282 ）
• 2 回目の発生。並行スプリントのたびに起きる前提で扱う

（書き手: 起票者（m26-1 の conductor）、日付: 2026-10-31）

受け入れ条件

1. スプリントの配布と本番のプランは、版数をプランを作る時点で書き込まない。配布のステップを流す時点に、その時点の develop と main の版から決める
2. プランを作ってから配布するまでの間に、並行する別のスプリントがその版を出しても、プランを作り直さずに、次に空いている版で配布が進む
3. 本番のプランは、同じスプリントの開発版が使った版の系列（接尾辞を外した版）で出す。決めた版数は配布と本番の結果 JSON に載る
4. 版数を明示して作ったプランは、その版がすでに出ていれば配布の前に止まり、別の版で黙って進めない

5. 版数を流す時点に決めたプランは、自分の配布がベースブランチへマージされる前に別のスプリントがその版を出しても、流し直しで次に空いている版へ決め直して進む。決め直した前の版と理由は版の記録に残る（2026-11-01 承認ゲート 1 で利用者が案 B を選んだ）

（書き手: 起票者（棚卸しで足した AI）、日付: 2026-10-31 ごろ）

同じ事象を PR #2247 の作業中に確認した。

同じ事象を PR #2298 の作業中に確認した。

（書き手: 起票者（out-of-scope の追記の形）、日付: 2026-10-31）

起票者の推定

題・本文はすべて起票者が書いた。承認ゲート 1 で利用者が確かめるまで、利用者の決定として扱わない。

目的

• 並行する別のスプリントが先に版を出しても、プランを作り直さずに配布まで進める（Vision: 人が手を止めるのは承認の 2 回に寄る。2 回の再発では conductor の作り直しと版の書き換えで止まった）
• 古いプランが既に使われた版より古い版へ戻して配布する事故を、配布の前に止める

前提

• 前提 1: 対象は supervise.py が組むスプリントのプランのうち、配布を雛形で組むもの（.ndf/release.json の form: package-plugin。版数が要るのは delivery.needs_version が真の経路だけ）。雛形で組まない経路は版数を持たないので変えない
• 前提 2: 「使われた版」（この要求の中だけの言い方。リリース済み版より広く開発版も含む）は、開発版なら origin のベースブランチ（.ndf/worktree.json の base_branch。ai-plugins は develop）の plugin.json の版、正式版なら origin のリリースタグ（<plugin>--v<版>）と本番のブランチの版で判定する。どちらも配布のステップの開始時に git fetch した後の値を読む
• 前提 3: 開発版の版の決め方は「版と配布の方針」に従う。ベースブランチの版が未リリースの正式版 X の開発版 X-dev.N なら X-dev.(N+1)、そうでなければ（ベースブランチの版が正式版、または X のタグがすでにある）最新のリリースタグの版を上げ幅で上げた Y の Y-dev.1
• 前提 4: 上げ幅（PATCH / MINOR / MAJOR）はプランを作る時点で指定でき、指定が無ければ PATCH とする（マイルストーンの間は PATCH で出す運用に合わせる）。上げ幅を版の決め方へどう渡すかは設計が決める
• 前提 5: m26-1 でスプリント PR が「版の行で衝突した」仕組み（スプリントの PR が版の行を持った理由）は調べていない。この要求は配布と本番のプランが版を決める時点だけを扱い、スプリント PR の衝突は受け入れ条件 2 が満たされたときに起きなくなるかを設計で確かめる

対象範囲

含む:

• supervise.py new sprint / new close が組む開発版と本番のプラン（MVV 判定で進めるもの・pace: normal の配布を含む）が、版をどの時点に決めるか
• 版を名前に持つもの（worktreeのパス・ブランチ名 release/v<版>・承認資料のパス・CHANGELOG の節・タグ）が、決めた版に揃うこと
• 配布の bump が、既に使われた版以下へ版を戻さないこと
• 決めた版を開発版と本番の結果 JSON（metrics.version）に載せること

含まない:

• 雛形で組まない配布の経路（delivery の行ごとの経路）
• 上げ幅を中身から自動で決めること（前提 4 のとおり指定か既定の PATCH）
• スプリントでない単独の supervise.py new release の版の決め方（版を明示して作るので、受け入れ条件 4 の止まり方だけが当たる）
• 他のプラグインの上げ幅（bump-others・changed-plugins）の決め方
• 承認ゲート 2 の承認の記録の形（approved_sha で中身を照合する仕組み）

ドメインイベント

用語

受け入れ条件

• 1. 版数を明示せずに作ったスプリントのプラン（sprint.json と、開発版・本番のプランのファイル）は、具体的な版数（10.27.6-dev.1 のような文字列）を持たない。worktreeのパス・ブランチ名・承認資料のパスも、プランを作った時点では版を含まない
• 2. 開発版の配布のステップは、流した時点の origin のベースブランチの版と最新のリリースタグから版を決める。例: ベースブランチが 10.27.5・最新のタグが ndf--v10.27.5・上げ幅 PATCH なら 10.27.6-dev.1。ベースブランチが 10.27.6-dev.1 でタグ ndf--v10.27.6 が無ければ 10.27.6-dev.2
• 3. プランを作った後、配布の前に別のスプリントがベースブランチか本番のブランチへ版を出しても、同じプランをそのまま流すと、2 の規則で次に空いている版に決まり開発版の配布が終わる。conductor がプランを作り直す・版を書き換える操作は要らない（作った時点のベースブランチが 10.27.5、配布の前に別のスプリントが 10.27.6 を本番へ出したなら 10.27.7-dev.1）
• 4. 版数を明示して作ったプランは、明示した版がすでに出ていれば（開発版はベースブランチの版と同じかそれより大きい版がある、正式版は同じ版のタグがある）、bump より前に止まり、止まった理由と既に出ている版を結果 JSON に載せる。別の版へ移って進まない
• 5. 配布の bump は、新しい版がベースブランチの版以下（semver の比較で同じか小さい）なら、ファイルを書き換えずに止まる（例: ベースブランチが 10.27.5 のとき --to 10.27.5-dev.1 は止まる）。同じステップの打ち直し（作業場所がすでに新しい版で、ベースブランチの版より大きい）は今と同じく ok で返る
• 6. 本番のプランは、同じスプリントの開発版の版の系列（接尾辞を外した版。承認資料が持つ版）で出す。その版のタグがすでにあれば、本番のブランチへ入れる前に止まり、人へ戻す（止まった理由・既に出ている版・次に空いている版を結果 JSON に載せる）。別の版で黙って進めない
• 7. 同じプランの開発版の配布のステップを流し直すと、最初に決めた版を使う（自分が出した開発版を「使われた版」と見て次の版へ進まない）
• 8. 版を決めるときに origin のベースブランチ・本番のブランチ・タグのどれかを読めなければ、版を推定せずに止まり、読めなかったものを結果 JSON に載せる
• 9. 開発版と本番の結果 JSON（release-steps.py release の出力）の metrics.version に、決めた版が載る
• 10. 版数を明示して作ったプランで、明示の版がまだ出ていなければ、今と同じ版・同じステップで配布が進む（退行しない）

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

進行

モード: — / 進め方: auto

• 要求と受け入れ条件 — 2026-11-01 01:18
• 作業場所の用意 — 2026-11-01 02:54
• 設計 — 2026-11-01 01:22
• 素材の収集と出典の確定
• ドキュメント再構成
• ドキュメントレビュー
• 計画 — 2026-11-01 02:53
• 実装 — 2026-11-01 03:43
• 構造改善 — 2026-11-01 05:23
• 実装レビュー — 2026-11-01 06:24
• 完了判定 — 2026-11-01 04:16
• Pull Request — 2026-11-01 04:32
• 確定仕様化 — 2026-11-01 07:43
• 後片付け — 2026-11-01 07:42
• 配布 — 2026-11-01 07:24
• 体裁レビュー
• リリース後テスト — 2026-11-01 07:59
• 振り返り — 2026-11-01 08:08
• 棚卸し — 2026-11-01 08:21

振り返り: #2352 (comment)

閉じた理由

直っています。版数を配布のステップを流す時点に決める変更（PR #2345、スプリント PR #2348）がマージされ、ndf v10.27.10 以降に入っています。キューが流す時点に次に空いている版を決めて版の記録に残し、明示の版がすでに出ていれば止まります（supervise_lib/queue_fill.py）。リリース後テストと振り返りも済んでいます。