release の雛形が本番のブランチを既定ブランチへ後退させず、worktree.json に production_branch が無いと本番のプランを組めない #2097

依頼（原文）

何を見つけたか

.ndf/worktree.json に production_branch が無く、.ndf/supervise.json に release.form: package-plugin があるリポジトリで、supervise.py new release --version 1.0.0 --prs 1 --channel prod --worktree <根>/.worktrees/release/v1.0.0 --out <パス> を打つと、supervise.py: error: 本番の配布に要る本番のブランチが無い（--production-branch か .ndf/worktree.json の production_branch） で止まる（2026-10-24 に一時ディレクトリで再現）。

同じ宣言で、リリースの経路の判定（lib/delivery.py）は本番のブランチを既定ブランチ（origin/HEAD）へ後退して決め、経路を雛形（template）と判定する。

どこで見つけたか

• plugins/ndf/scripts/supervise_lib/release_templates.py の _validate_release_decl: a.production_branch だけを見る
• plugins/ndf/scripts/supervise_lib/decl.py:257: a.production_branch は引数か worktree.json の production_branch だけから決まる
• plugins/ndf/scripts/lib/delivery.py:132-136・lib/repo.py:136 の production_branch: production_branch が無ければ既定ブランチ（origin/HEAD）を使う
• 用語集の「本番」の行は「production_branch（無ければ既定ブランチ）」と書く

#1914 の設計（normal の new sprint が本番のプランを書き出す）で、本番のプランを組むときに見つけた。

なぜこの変更の範囲外なのか

#1914 の受け入れ条件は、pace: normal の new sprint が承認ゲート 2 と本番のステージを書き出すことで、本番のブランチの決め方は含まない。この食い違いは fast / auto と単独の new release --channel prod にも同じ形である。#1914 の設計は、本番のブランチ（a.production_branch）が無いときは本番のステージを置かない形で、今の振る舞いを変えずに避ける。根拠: Value 6（MVV 版 2。根本原因の層で直すため、本番のブランチの決め方を 1 か所にそろえる変更として分ける）

直さないと何が起きるか

worktree.json に production_branch を書かず既定ブランチを本番にしているリポジトリでは、経路は雛形と判定されるのに本番のプランを雛形で組めず、new release --channel prod も fast / auto の new sprint も止まる。#1914 の後は normal の new sprint が本番のステージを置かず、本番を手で配る手当てが残る。

起票者の推定

• 雛形の本番のブランチは、経路の判定と同じく既定ブランチへ後退するのが正しい（推した出所: lib/repo.py:137 の docstring と用語集の「本番」の行）

修正レイヤー

supervise_lib/decl.py の apply_decls（255〜256 行）は lib/repo.production_branch（worktree.json の production_branch → 既定ブランチ）を呼ぶ形になっている。ただし既定ブランチを解く木に decl_roots の先頭（--worktree のパス）を渡すため、まだ作っていない worktree では既定ブランチ（origin/HEAD）を解けず、同じエラーで止まる。直す場所は、既定ブランチをメインディレクトリ（存在する木）から解く形にすることである。ai-plugins は production_branch を宣言しているため、この経路を通らない。

2026-10-31 に一時のリポジトリで再現した（{"base_branch":"main"} だけで止まり、production_branch: main を足すと 12 ステップのプランが ok）。2026-11-04 にも同じ形（origin/HEAD は main、.ndf/supervise.json は release の form・plugin・runtimes）で同じエラーになることを確かめた。

由来

issue #1914

（書き手: 起票者（#1914 の設計の途中で範囲外の課題として起票した AI）、日付: 2026-10-24 起票、「修正レイヤー」の節は 2026-10-31・2026-11-04 の追記。利用者の指示の原文は含まない）

起票者の推定

目的

• .ndf/worktree.json に production_branch を書かず、既定ブランチを本番にしているリポジトリで、supervise.py new が本番の配布を含むプランを組めるようにする
• 本番のブランチの決め方を、リリースの経路の判定（lib/delivery.py）とプランの雛形（supervise_lib）で同じ結果にそろえる（Value 6・Value 7）

前提

• 前提 1: 本番のブランチの決め方の正本は、今ある lib/repo.py の production_of（production_branch の宣言 → 既定ブランチ）とする。順序は変えない
• 前提 2: 既定ブランチは、まだ作っていない worktree のパスではなく、存在する git の木（--repo、--worktree のパスの /.worktrees/ より前、今のディレクトリの順で最初に git として読める木）から解く。メインディレクトリから解いた既定ブランチと、そのリポジトリの worktree から解いた既定ブランチは同じ値になる（origin の HEAD はリポジトリで 1 つ）
• 前提 3: 本番のブランチが既定ブランチに決まっても、リリースプランは承認ゲート 2（approve のステップ）を持ったままにする。この変更は承認の要否を変えない
• 前提 4: 2026-11-05 に一時のリポジトリで確かめた今の振る舞いを基準にする。worktree を作る前は上の「依頼（原文）」と同じエラーで止まり、git worktree add で worktree を作った後は同じコマンドが 13 ステップのリリースプランを書く

対象範囲

含む:

• supervise.py new の release・sprint・close（本番を使う雛形）で、本番のブランチを既定ブランチへ後退させる経路が、まだ作っていない worktree でも働くこと
• 本番のブランチが決まらないときのエラーの文面に、3 つの出所（--production-branch、.ndf/worktree.json の production_branch、既定ブランチ）をそろえて書くこと

含まない:

• 本番のブランチの決め方の順序と出所を変えること（前提 1）
• 昇格のプラン（delivery_templates.py の本番チャネルの決め方）の振る舞いを変えること。同じ既定ブランチの補完を受けるかは設計で確かめ、変わる場合は受け入れ条件 6 の退行の確認に含める
• ai-plugins の .ndf/worktree.json の production_branch を消すこと（C7）
• 承認ゲート 2 の置き方・要否を変えること
• 型・クラスの追加と変更（関数を 1 つ足し、呼び出し元の引数を変えるだけで、クラス図の対象が無い）

ドメインイベント

受け入れ条件

• 受け入れ条件 1: origin の HEAD が main を指し、.ndf/worktree.json が {"base_branch":"main"} だけで、.ndf/supervise.json の release に form: package-plugin・plugin・runtimes があるリポジトリで、まだ作っていない worktree のパス（<メインディレクトリ>/.worktrees/release/v1.0.0）を --worktree に渡して supervise.py new release --version 1.0.0 --prs 1 --channel prod --out <パス> を打つと、終了コード 0・結果 JSON の status が ok で、approve・snapshot・release・verify のステップを持つリリースプランを書く
• 受け入れ条件 2: 受け入れ条件 1 のプランで、本番の配布の確認に使うブランチ（verify などが参照する本番の ref）が main である
• 受け入れ条件 3: 受け入れ条件 1 のリポジトリで worktree を作った後に同じコマンドを打っても、受け入れ条件 1 と同じステップの並びのプランを書く（worktree の有無で結果が変わらない）
• 受け入れ条件 4: origin の HEAD もローカルの main / master も無く、production_branch も --production-branch も無いリポジトリでは、new release --channel prod が今と同じく止まり、エラーの文面が --production-branch・.ndf/worktree.json の production_branch・既定ブランチの 3 つを挙げる
• 受け入れ条件 5: 受け入れ条件 1 のリポジトリで、まだ作っていない worktree のパスを渡した supervise.py new sprint（pace: normal・fast・auto のそれぞれ）が、承認ゲート 2 と本番のステージを置いたプランを書き、「本番のブランチ（…）が無いため、承認ゲート 2 と本番は置いていない」の案内を出さない
• 受け入れ条件 6: 退行しないこと。production_branch を宣言したリポジトリ（宣言の値が既定ブランチと違う場合を含む）では宣言の値を、--production-branch を渡したときは引数の値を本番のブランチに使う。ai-plugins のメインディレクトリで受け入れ条件 1 と同じ new release --channel prod を打った結果のプランが、変更の前後で同じ JSON になる
• 受け入れ条件 7: 受け入れ条件 1 の宣言で、リリースの経路の判定（lib/delivery.py）が使う本番のブランチと、リリースプランが使う本番のブランチが同じ値になる

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

進行

モード: — / 進め方: auto

• 要求と受け入れ条件 — 2026-11-05 11:36
• 作業場所の用意 — 2026-11-05 12:27
• 設計 — 2026-11-05 11:38
• 素材の収集と出典の確定
• ドキュメント再構成
• ドキュメントレビュー
• 計画 — 2026-11-05 12:27
• 実装 — 2026-11-05 12:28
• 構造改善 — 2026-11-05 13:47
• 実装レビュー — 2026-11-05 14:39
• 完了判定 — 2026-11-05 12:47
• Pull Request — 2026-11-05 13:19
• 確定仕様化 — 2026-11-05 19:14
• 後片付け — 2026-11-05 19:52
• 配布 — 2026-11-05 15:01
• 体裁レビュー
• リリース後テスト — 2026-11-05 19:47
• 振り返り — 2026-11-05 19:47
• 棚卸し — 2026-11-05 19:52

振り返り: #2587 (comment)