Factory の開発ループ: 予算の欄を空にしたら NDF の既定値へ戻す #2406

依頼（原文）

何をするか

Factory の開発ループで、画面の予算の欄を空にしても NDF の既定値（.ndf/pace.json の loop.budget）へ戻らない。空欄の扱いを決めて直す。

経緯

• スプリント lfactory2-3 の検査で、クロスレビューが上限に達して後へ回した指摘（スプリント lfactory2-3 #2397 、factory/api/src/runs/control.ts:402、major）
• NDF に予算を既定値へ戻す引数が無く、Factory は各リポジトリの既定値を知らない

決めること

• NDF の CLI に既定値へ戻す引数を足すか、画面で空欄を許さないか

受け入れ条件

• 予算の欄を空にした後の周回で、NDF がリポジトリの既定の予算で止まる条件を判定する。または画面が空欄を断り、理由を出す

（書き手: 起票者、日付: 2026-11-02。スプリント lfactory2-3 の検査で後へ回した指摘を、AI が起票の記録として書いた本文である。利用者の指示の原文は含まない）

指摘の原文（ #2397 の修正のまとめ round 1。書き手: AI のレビュー担当）:

予算の宣言をnullへ戻す更新も、NDFの既定値へ戻す操作として伝えてください。たとえばusd=10で始めた後に費用欄を空にしても、このフィルターで変更が消え、次の周回は（以下、記録で切れている）

起票者の推定

依頼の全文が起票者の文であるため、題と本文の条件をすべてここに並べる。S4〜S6 は要求の工程で足した条件である。承認ゲート 1 で利用者が確かめるまで、利用者の決定として扱わない。

目的

• Factory の利用者が開発ループの予算の欄を空にして保存したとき、次の周回から NDF がそのリポジトリの既定の予算で止まる条件を判定する状態にする
• 画面に出る予算と、NDF が止まる条件の判定に使う予算を食い違わせない

前提

• 前提 1: 今の食い違いの仕組みは次のとおりである。サービスは実行ジョブの指示に、値のある単位だけを LOOP_BUDGET として並べる（factory/api/src/runs/control.ts の buildInstruction）。NDF の予算の上書き（plugins/ndf/scripts/lib/sprint_loop.py の apply_budget）は渡された単位だけを上書きする。そのため、一度 usd=10 を渡したループの費用の欄を空にしても、ループの記録の費用の予算は 10 のまま残る
• 前提 2: リポジトリの既定の予算は、既定へ戻す時点のメインディレクトリの .ndf/pace.json の loop.budget の値である。宣言が無い単位は NDF の組み込みの既定（周回 3・費用 60 USD・時間 24 時間。plugins/ndf/scripts/lib/pace.py の LOOP_DEFAULTS）である。ループを始めた時点の値を覚えておくのではない
• 前提 3: 予算の変更の API（factory/api/src/runs/loops.ts の updateBudget）は、3 つの単位をまとめて置き換える。送らない単位と null の単位は「空」として扱う。この契約は変えない
• 前提 4: Factory の開発ループ: 再開したジョブへ変えた予算を届ける #2405（再開のジョブへ変えた予算を届ける）の実装が、この課題の実装より先にマージされる。Factory の開発ループ: 再開したジョブへ変えた予算を届ける #2405 は、NDF に予算だけを反映する副命令（sprint-state.py loop budget）を足し、再開のジョブにも LOOP_BUDGET を載せる（issues/issue-2405-design.md）。Factory の開発ループ: 再開したジョブへ変えた予算を届ける #2405 が先にマージされないときは、受け入れ条件 4 を再開のジョブの経路ができた時点へ持ち越す
• 前提 5: Factory は NDF の版ごとの対応を版の比較で判定する前例を持つ（factory/api/src/runs/version.ts の isLegacyVersion と、並行の実行を許す最小の版の設定）。受け入れ条件 7 の判定も同じ考え方で作れる
• 前提 6: 既定へ戻す指示を、記録が既に既定の値である単位へ出しても、予算の履歴に行は足さない。サービスは前の値を覚えずに、空の単位を毎回「既定へ戻す」として渡してよい

対象範囲

含む:

• NDF の開発ループの予算の上書きに、単位ごとに「リポジトリの既定へ戻す」指示を足すこと（loop start と、Factory の開発ループ: 再開したジョブへ変えた予算を届ける #2405 の loop budget の両方）
• サービスが実行ジョブの指示に空の単位を「既定へ戻す」として載せ、ランナーが NDF へ渡すこと（周回のジョブと再開のジョブ）
• 実行ジョブの指示の契約（factory/contracts/schemas/run-job-instruction.schema.json の LOOP_BUDGET）の変更
• 予算の単位が空のときの画面の表示（一覧と詳細の「予算の残り」、予算の欄）
• 既定へ戻す手段を持たない NDF の版で動くループで、空にする変更を断ること
• 確定仕様（docs/specifications/ndf-factory-dev-loops*.md・docs/specifications/ndf-factory-contracts-and-progress.md・docs/specifications/ndf-workflow-development-loop.md）と NDF の手順（plugins/ndf/skills/development-workflow/references/loop.md）の予算の記述

含まない:

• Factory が各リポジトリの既定の予算の値を読んで画面に出すこと。既定の値の正本は各リポジトリの .ndf/pace.json に置いたままにする
• 再開のジョブへ予算を届ける経路そのもの（Factory の開発ループ: 再開したジョブへ変えた予算を届ける #2405 が持つ）
• 動いているジョブ（running）の途中で予算を届けること
• 止まった（stopped）・取り消した（cancelled）ループの予算の変更
• 予算を「掛けない」（上限を外す）状態を新しく作ること。NDF のループの予算は 3 単位とも常に正の数を持つ

ドメインイベント

用語

受け入れ条件

• 1. 費用の予算 10 USD で始めたループの費用の欄を空にして保存すると、次の周回のジョブの後、NDF のループの記録の費用の予算がリポジトリの .ndf/pace.json の loop.budget.usd の値になる（サービス・ランナー・NDF のテストで、指示・NDF へ渡す引数・記録の予算をそれぞれ確かめる）
• 2. 受け入れ条件 1 のループで、締めた周回の費用の和が 15 USD（古い予算 10 以上、既定の予算未満）のとき、NDF は budget_usd の止まる条件を記録しない（NDF のテストで確かめる）
• 3. .ndf/pace.json に loop.budget の宣言が無い単位を既定へ戻すと、NDF の組み込みの既定（周回 3・費用 60・時間 24）になる
• 4. 承認待ちのループの予算の単位を空にした後、承認の答えで作られた再開のジョブでも、受け入れ条件 1 と同じくループの記録の予算が既定の値になる（前提 4）
• 5. 既定へ戻す指示で予算が変わったときは予算の履歴に 1 行だけ足し、変わらないとき（既に既定の値のとき・新しいループを始めるとき）は足さない
• 6. 予算の単位が空のループでは、一覧と詳細の予算の残りに、その単位がリポジトリの既定に従うことが分かる文言を出す。「掛けない」（上限が無い）とは出さない。文言は翻訳のファイルに置く
• 7. 既定へ戻す手段を持たない NDF の版で動くループで、値のあった単位を空にする変更は、画面と API の両方で断る。理由（その版では既定へ戻せないこと）を返し、画面はその理由を出す。値を入れる変更と、もともと空の単位を空のままにする変更は断らない
• 8. 3 つの単位すべてに値のあるループの周回と再開は、指示・NDF へ渡す引数・ループの記録の予算がこれまでと変わらない
• 9. 予算の欄をすべて空にして始めたループは、これまでどおり NDF の既定の予算で動く
• 10. 「既定へ戻す」を表す値が数でも既定へ戻す指示でもないとき、NDF はループの記録を変えずに引数の誤りとして断る

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

進行

モード: — / 進め方: auto

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

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

• 判定: unknown（承認ゲート 1）
• 理由: 設計の中身は MVV に沿っている。既定の値の正本をリポジトリの .ndf/pace.json の一か所に置き、Factory に値を写さない（決定 2）。経路を増やさずに値 default で受け渡す（決定 1）。古い NDF の版へは default を送らず、理由を付けて断る（決定 4・5）。これらは Value 5・Value 6・Value 7 と上位の原則（人を守る）に合う／画面と API・MCP は同じ断りの code（budget_reset_unsupported）を返す。画面の文言は翻訳のファイルに置く（決定 6）。空の予算の単位は『掛けない』でなく『リポジトリの既定』と出す（決定 7）。これらはスプリント Value 1・スプリント Value 4・スプリント Value 5 に沿う。データの移行も要らない（決定 3）／一方で、配布の前に取れる検査 requirements-check が終了コード 2 で止まっている。issues/issue-2406-requirements.md を読めなかったためで、原因は未確認と書かれている。要求と受け入れ条件の文書が正しく揃っているかを材料から確かめられない。設計の承認を MVV 判定だけで通すには根拠が足りない（Value 1「確かめていないものを済んだと記録しない」、Value 2「承認資料の正しさ」）／必ず人の承認が要る操作は、この変更に含まれない。秘密（C1）・認証と認可（C2）・利用者のデータの移行（C3）・戻せない操作（C4）・他のリポジトリへの公開（C5）・.ndf/ と CLAUDE.md の書き換え（C7）・配布物の取得元と版の規則（P1）のどれにも当たらない。NDF_BUDGET_RESET_MIN_VERSION は Factory の内部の設定で、配布の版の規則（P1）ではない
• 根拠の項目: Mission, Vision, Value 1, Value 2, Value 5, Value 6, Value 7, スプリント Value 1, スプリント Value 4, スプリント Value 5, C3, C5, C7, P1
• 設計 Pull Request: Factory の開発ループ: 予算の欄を空にすると、次のジョブからリポジトリの既定の予算で止まる判定を行う（#2406） #2541
• 答え: approved
• 答え方: python3 /persistent/ai/.claude/plugins/cache/ai-plugins/ndf/10.27.19/scripts/sprint-state.py loop answer lfactory3 2406 --approved|--rejected|--revise --note <指摘ファイル>

振り返り: #2587 (comment)