開発ループのスプリントが版を流す時点に決められず、並行するスプリントと版がぶつかると止まる #2354

開発ループ（sprint-state.py loop sprint）から組むスプリントでも、開発版の版をリリースのプランを流す時点に決められるようにする。大方針 #2335 の柱 #2344「プランは値でなく参照を持ち、実行の直前に解決して照合する」の子の課題である。

依頼（原文）

この課題の題と本文は、起票者（課題を書いた AI）が 2026-11-01 に m26-3 のリリース後テスト（Pull Request #2351）の記録として書いた文で、利用者の指示の原文ではない。

起票時の本文（書き手: 起票者、日付: 2026-11-01）:

開発ループ（sprint-state.py loop sprint）は --dev を必須の引数にしている（plugins/ndf/scripts/lib/sprint_loop_cli.py:109 の required=True）。受け取った版を supervise.py new sprint --version <開発版> へそのまま渡す（plugins/ndf/scripts/lib/sprint_loop.py:292-294）。

ndf 10.27.6 では、new sprint で --version を省くと、配布のステップを流す時点で版が決まる（#2164）。ところが開発ループから組むスプリントは必ず「明示の版」のプランになるため、この経路を選べない。並行する別のスプリントが先にその版を出すと、ループのスプリントは配布の前に止まる（#2164 の受け入れ条件 4）。そこから先は、人か conductor が版を決め直して組み直すことになる。

確かめたこと（2026-11-01 17:05 JST、導入した ndf 10.27.6）:

• python3 sprint-state.py loop sprint --help を打つと、使い方の行が --mode MODE --dev DEV（必須）になっている
• sprint_loop.py:294 は、--version に lap["versions"]["dev"] を渡して new sprint を組む

• m26-3（リリース記録の PR を、まとめのプランを組む時点でなく実行の時点で解決する #2230 new close: merge・手動の経路のスプリントで、リリース記録の PR をまとめの close へ渡す手段が無く、課題が --record-pr unknown で開いたまま残る #2044 開発ループの承認ゲート 2 の後のまとめが配布の記録の PR を読まない → 本番の後に記録の PR を解いてまとめを組む（#2089） #2121 スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164）のリリース後テスト（Pull Request Release: ndf v10.27.6 #2351）
• スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164 の設計の「未確認」に「sprint-state.py loop sprint の --dev … 範囲外の課題として起こす」とあるが、まだ起票されていない（承認資料 issues/approval-ndf-v10.27.6.md の 34 行目）

#2164 の要求の対象範囲は supervise.py new sprint / new close が組むプランであり、開発ループの引数は含まない。開発ループからは明示の版のプランとして受け入れ条件 4・10 が当たるため、退行はしない。根拠: Value 4（手当てを雛形へ入れる）・Vision（人が手を止めるのは承認の 2 回に寄る）（MVV 版 3）。

開発ループで回すスプリントだけが、#2164 で無くした「並行するスプリントが先に版を出すとプランを作り直す」手当てを残す。ループは人を介さずに周回を続けることが目的のため、版がぶつかるたびに周回が止まり、人へ戻る。

由来: PR #2351

柱への結び付け（書き手: 起票者、日付: 2026-11-01。課題のコメント）:

大方針 #2335 の柱 #2344（プランは参照を持ち、実行の直前に照合する）の子として扱います（スプリント lroot-2 の棚卸し）。

範囲の指示（書き手: 利用者、日付: 2026-11-05。#2344 の設計承認ゲート の答え。#2344 の本文から引用した）:

範囲を、起きた不具合に根拠のあるものに絞る: 版数・リリース記録の PR の直前の解決（#2164）・実行条件を先に評価（#2349）・流し直しの判定（#2349）・開発ループの版（#2354）。

この要求の整理の指示（書き手: AI の起動指示、日付: 2026-11-06）:

人へ問わずに進め、決められない点は前提か未決として課題の本文へ書く。

解釈: 開発ループの周回で、版の指定を不要にする。--dev を渡さなければ new sprint に --version を渡さず、#2164 の経路（流す時点に次に空いている版を決める）へ載せる。あわせて、版を渡さなくても周回の記録に出した版が残る状態を保つ。今の --dev を渡す使い方は残す。

起票者の推定

目的

• 開発ループの周回が、並行するスプリントの開発版のデプロイで止まらず、プランを作り直さずに次に空いている版で開発版を出す状態にする
• conductor が周回ごとに版を決める手順を無くし、判断の要らない手順をスクリプトへ寄せる

今の開発ループは版を必須で受けるため、ループのスプリントだけが #2164 の経路を選べない。

前提

• 前提 1: この課題は プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の実装を待たず、スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164 で入った版の差し込みの上で完結する。プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の受け入れ条件 8（--dev を省いて起動でき、省いたらプランが版を参照で持ち、渡せば明示の版になる）は、この課題の受け入れ条件 1・2・5 で満たす形にそろえる。後から プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 が差し込みを参照の部品へ寄せても、開発ループの側は「--version を渡さない」だけなので変更が要らない。確認: origin/develop（ac5389bae）に plugins/ndf/scripts/lib/refs.py は無く（ls で確認）、git grep -n 2344 -- 'plugins/ndf/scripts/**/*.py' は 0 件で、プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 は未完了（OPEN）である
• 前提 2: --dev は引数として残す（任意にする）。特定の版で出す必要があるときの手段である。手順書の既定の打ち方は --dev を渡さない形にする
• 前提 3: 本番の版が既出のときに自動で次へ移らない スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164 の規則（同じ設計の不変条件 I4・I5）は変えない。リリース承認ゲート で判定した承認資料の版と、出す版を食い違わせないためである。したがって本番のプランまで進んだ後に別のスプリントが同じ版を本番へ出した場合は、今と同じく止まって人へ戻る
• 前提 4: 版を決める規則（decide_dev・taken・bump の止まり方）は変えない。開発ループがどの経路を選ぶかだけが変わるため、必ず人の承認が要る操作 P1（リリース対象の取得元・版の規則の変更）に当たらない
• 前提 5: 版がぶつかる頻度は測らない。この変更は手順を減らすもので、頻度によらず周回の止まる経路を 1 つ無くす
• 前提 6: 適用範囲は スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164 と同じく .ndf/supervise.json の release.form が package-plugin で、delivery.needs_version が真の経路である

対象範囲

含む:

• sprint-state.py loop sprint の --dev を任意にし、省いたら new sprint へ --version を渡さないこと
• --dev を省いて --prod だけを渡した呼び方の扱い
• 周回の記録（loop.json・laps.md）の版を、版の記録から埋めること
• 開発ループの案内の文（loop select と止まった後の next）と手順書 references/loop.md の打ち方
• -- --level <上げ幅> で上げ幅を渡せることの確認

含まない:

• 版を決める規則そのものの変更（前提 4）
• 本番の版が既出のときの自動の移動（前提 3）
• 差し込みを参照の部品へ寄せること（プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の範囲）
• 並行するスプリントの版の取り合いを排他にすること（プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の設計が「測っていない」としている項目）
• new sprint / new close を直接打つ経路の変更（スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164 で完了）
• 確定仕様 docs/specifications/ndf-release-version-at-run-time.md の「運用」の 289 行目の書き換え（確定仕様化の工程で行う）

ドメインイベント

用語

受け入れ条件

• 1. loop sprint <名> --mode <モード> は --dev なしで終了コード 0 で返る。組んだ開発版のプランの「版」の欄の 明示 は空（null）で、プランのファイルと sprint.json に X.Y.Z の形の版数が無い
• 2. --dev なしのとき、周回の記録の sprint_command に --version が無い
  前提の確認: sprint-state.py init と supervise.py new sprint --pace auto（--version なし）を打つと 0 で返り、7-release.json の「版」の欄の 明示 は None、版数の形は 0 件（2026-11-06、この課題の worktree で実行）
• 3. --dev なしで組んだ後、origin のベースブランチと本番へ 10.27.6 とタグを足してから開発版のプランの差し込みを流すと、プランを作り直さずに 10.27.7-dev.1 で埋まり、版の記録の how は decided である（一時の git リポジトリで確かめる）
• 4. --dev なしで組み、版の記録を書いた後に別のスプリントがその版を出し、自分のリリースがマージされていない状態で流し直すと、周回を止めずに版を決め直す。history に 1 件入る
• 5. --dev <版> を渡すと、今と同じく new sprint --version <版> を打ち、開発版のプランの 明示 がその版になる。その版が既出なら、今と同じく流さず version.cause が taken になる（退行しない）
  前提の確認: supervise.py new sprint --pace auto --version 10.28.0-dev.1 の 7-release.json の 明示 が 10.28.0-dev.1（2026-11-06）。既出の扱いは スプリントのプランが作った時点の版数を配布と本番のプランへ書き込み、並行する別のスプリントがその版を先に出すとプランを作り直すまで止まる #2164 の不変条件 I5
• 6. --dev <版> を渡したとき、周回の記録の versions は今と同じく開発版とその接尾辞を外した本番の版（--prod があればその版）を持つ（退行しない）
• 7. --dev なしで --prod <版> を渡すと、終了コード 1 で断り、理由に「--prod は --dev と一緒に渡す」旨が出る。状態ファイルを作らず、new sprint を打たず、ループの記録を変えない
• 8. loop sprint <名> --mode <モード> -- --level minor で組んだ開発版のプランの 上げ幅 は minor である
  前提の確認: supervise.py new sprint --pace auto --level minor の 7-release.json の 上げ幅 が minor（2026-11-06）
• 9. --dev なしの周回で開発版のプランが版の記録を書いていれば、周回を締めた後の versions.dev は版の記録の版で、laps.md の版の列に出る。版を決め直した周回は決め直した後の版が載る
• 10. --dev なしの周回で版の記録が無い、または読めないとき、周回は今の結果のまま締まり、versions.dev は空で、laps.md の版の列は空である（周回の締めを止めない）
• 11. loop select の next と、refused で止まった後の next が示す 1 行は --dev を求めず、その行のモードを埋めて打つと受け入れ条件 1 のとおり組める
• 12. sprint-state.py loop sprint --help の使い方の行で --dev が任意（[--dev DEV]）になっている
  前提の確認: 今は --dev なしで打つと終了コード 2 で the following arguments are required: --dev（2026-11-06）
• 13. references/loop.md の手順 2・3 の打ち方は --dev を渡さない形で、conductor が版を決める手順が無い。書いたコマンドはそのまま打って通ることを、書く前に実行して確かめる
• 14. pytest plugins/ndf/scripts/tests/test_sprint_loop.py が通る。--dev を渡す既存のテストの期待値は変えない（next の文面を確かめる行を除く）
  前提の確認: 変更前に uv run --frozen --project . --all-extras pytest plugins/ndf/scripts/tests/test_sprint_loop.py -q -n 4 → 184 passed（2026-11-06）

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

進行

モード: — / 進め方: auto

• 要求と受け入れ条件 — 2026-11-06 11:07
• 作業場所の用意 — 2026-11-06 22:36
• 設計 — 2026-11-06 11:16
• 素材の収集と出典の確定
• ドキュメント再構成 — 2026-11-06 11:25
• ドキュメントレビュー
• 計画 — 2026-11-06 22:36
• 実装 — 2026-11-06 22:36
• 構造改善 — 2026-11-06 23:43
• 実装レビュー — 2026-11-07 00:48
• 完了判定 — 2026-11-06 22:51
• Pull Request — 2026-11-06 23:13
• 確定仕様化
• 後片付け
• デプロイ — 2026-11-07 01:09
• 体裁レビュー
• リリース後テスト
• 振り返り
• 棚卸し

人の判断待ち（開発ループ lroot4）

• 判定: unknown（承認ゲート 1）
• 理由: Mission・Vision: 開発版のぶつかりで周回が止まらなくなり、人が版を決め直す手間が減るため、「人の判断が要る所だけで止まる」方向に沿う／Value 5・6・7: 版の決定はキューの既存の処理に任せ、版の記録の読み取りは持ち主の層に置き、リリースの形ごとの分岐も足さないため、反する点は読み取れない／Value 2（決められないときは人へ戻す）: 設計は、要求の「版の出所は 2 つに限る」とレーンのリリースの依頼の答えという 3 つ目の出所の食い違いを残し、条件の文言を直すかは設計承認ゲートで人が見ると明記している。承認を省くと、人へ委ねたこの判断が抜けるため、AI だけでは決められない／Value 1（確かめていないものを済んだと記録しない）: 開発版のデプロイに失敗した周回でも、出していない開発版が周回の記録に載る。受け入れ条件 9 に従った動きとして未確認の欄に明記されているが、記録を「出した版」として読む非機能の条件との緊張があり、許容できるかは材料から決められない／P1・C1〜C8: 版の決定の規則は変えず、変更は文書 2 件で、実装の予定も plugins/ndf/ のスクリプト・テスト・手順書に限られる。.ndf/ や CLAUDE.md は書き換えないため、必ず人の承認が要る操作には当たらない
• 根拠の項目: Mission, Vision, Value 1, Value 2, Value 5, Value 6, Value 7, P1, C7
• 設計 Pull Request: 開発ループ: 周回ごとに版を決めずにスプリントを組み、並行するリリースがあっても次に空いている開発版で出す（#2354） #2679
• 答え: approved
• 答え方: python3 /work/ai-plugins/plugins/ndf/scripts/sprint-state.py loop answer lroot4 2354 --approved|--rejected|--revise --note <指摘ファイル>

設計承認ゲート での利用者の指摘（直して出し直す）

設計 PR 2679（#2354）を出し直す前に、次の 3 点を直す。

1. 決定 2（設計 105 行）の本番のプランの完了の判定を直す。人がリリース承認ゲート を承認して本番を出した周回でも、スプリント状態のプランの行の結果は前の done から作られるため元の値のまま残り、続きの run <本番のプラン> --from <ステップ> は done を書かない。今の判定だと本番の版が周回の記録に載らない。完了の確かめ方を、続きの実行も書く本番のプランの状態ディレクトリの report.md の「結果」へ変えるか、gate2_pipeline の続きの結果を done へ載せると決める。235 行の契約・図の H・I4 も合わせ、「承認して本番を出した周回に本番の版が載る」行をテスト設計へ足す。
2. glossary-check の失敗を直す。設計 105 行の廃止語を「承認ゲート」系の語へ置き換える。
3. requirements-check の exit 2（issues/issue-2354-requirements.md を読めない）の原因を確かめて再実行し、PR 本文のテストの表を結果に直す。止まった最終スイープは再レビューで補う。

設計の承認ゲート 1 での利用者の答え（2026-11-07）

• 本番の版の出所は要求の文言を実態に合わせて 3 つ（レーンの配布の依頼の答えを含む）に直す
• 開発版のデプロイに失敗した周回に、出していない開発版が載ることは「出す予定の版」として許容する