carul の根本原因 B-1: プランの差し込みの値と検査の件数を、今の起動の外から参照で解決する #2663

具体例

昇格だけの周回では、本番のプランの前に検査のステージが無い。{queue_prs} は今の queue の items からしか埋まらないので、record のステップが置き換えられずに落ち、まとめのプランが流されない（#2568）。検査のプランを途中から流し直すと、件数は最後の実行の state.json からしか写らないので、stats の findings が null になる（#2569）。

依頼（原文）

carulプロジェクトから大量のissueが届きました。
プロジェクトの進行に影響がある課題が多いので、そちらも1レーン使って対応します
ただし、いくつかの根本原因がトリガーのようですので、ひとつづつ直すのではなく根本原因を見つけて対処してください

阻害要因になっている上限の撤廃、保存先の永続化の問題、周回の問題が大きいようです

（書き手: 利用者、日付: 2026-11-06。親の課題 #2648 の本文から引用した）

次の文は課題を起票した AI の本文で、利用者の指示の原文ではない。

#2648（束 B）のうち、プランの差し込みの値と検査の件数を、今の起動の中の値でなく参照で解決する。

#2344（プランは値でなく参照を持つ。PR #2482 が版数・記録の PR・実行条件・流し直しを実装）の形に揃える。#2344 の範囲は広げず、この課題が同じ形で足す。

1. 検査のステージを含まない queue で流した本番のプランで、{queue_prs} がスプリントの PR で埋まり、record のステップが落ちない
2. 検査のプランを途中から流し直しても、検査の記録の行の findings が null にならず、全実行の件数になる
3. 1 と 2 をそれぞれ縛るテストがある
4. 昇格だけの周回で、昇格のプランの record が {queue_prs} を置き換えずに落ち、まとめのプランが流されない #2568・検査のプランを途中から流し直すと、検査の記録の行に前の実行のレビューの件数が入らず、stats の findings が null になる #2569 の再現の手順を 1 回ずつ通し、消えたものは理由を添えて閉じ、残ったものは理由を本文に書く

（書き手: 起票者、日付: 2026-11-06）

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

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

解釈: 利用者が求めているのは、carul の開発ループで周回が止まる原因を、課題ごとの手当てでなく原因の層で直すことである。この課題は、値の取り先が「今の queue・最後の実行」に限られている 2 か所（{queue_prs} の差し込みと検査の件数）を直す。

起票者の推定

題・本文のうち、利用者の指示の原文に無く、起票者が推して足した条件。S7〜S10 はこの要求の整理で足した。承認ゲート 1 で利用者が確かめるまで、利用者の決定として扱わない。

調べた事実

1. 周回 3 の昇格のプランは queue を通らず、run で流れた。 carul の loop.json の周回 3 の問いの記録の finish.pipeline は supervise.py run .../5-promote.json --from verify && supervise.py queue .../1-close.json ... である。周回 3 に状態ディレクトリがあるプランは昇格だけで、検査のプランは流れていない（lap-3/sprint/ の一覧）。record は error: argument --prs: invalid int value: '{queue_prs}' で終了コード 2 になった（lap-3/sprint/5-promote-state/run-stderr.log）。
2. {queue_prs} は残っても止まらない。 plan.py:219 の QUEUE_NAMED は {queue_pr:<名>}・{queue_state:<名>}・{queue_record} だけを検出し、{queue_prs} を含まない。queue でも先頭のステージでは fill_stage が prs = None にして埋めない（queue.py:224）。run は差し込みを解決しない（fill_stage の呼び出しは flow.py:289 の queue の経路だけ）。そのため文字列のままコマンドへ渡り、配布が済んだ後のステップで落ちる。
3. 前の実行の件数は記録に残らない。 carul の周回 2 の 4-check-state/state.json の log は最後の実行の 3 ステップ（merge-gate・merge・record）だけで、counts は持たない。実行の始まりごとに state.json は書き直される。進捗ログ（progress.jsonl）は追記だが、ステップの行に件数が無い（state.py:225 step_line）。出力のファイル（NN-<ステップ>.out）は番号が実行ごとに 1 から振り直され、同じ番号と名前なら上書きされる。
4. 課題を閉じる PR は GitHub から引ける。 周回 3 のまとめのプランの止まった理由は「課題 docs: Codex と Kiro の発動実測を単独条件で完了させる #110 Docs: cross-refactoring の実施計画と CLI 実機検証、Skill 一覧の計測修正 #114 feat: 全 Skill の description を新書式へ圧縮する（平均 237 → 150 文字） #102 を閉じる PR Task 3: ndf の統合が前提とする 3 つの仕様を実測する #143 を読んだが、本番か配布なしの段階のリリース記録が無い」であり（lap-3/done-2.json）、find_record は周回をまたいで Task 3: ndf の統合が前提とする 3 つの仕様を実測する #143 に届いている。

目的

• 昇格だけの周回でも、配布の後のリリース記録が人の手当て無しで残り、まとめのプランが流れる状態にする
• 検査のプランを途中から流し直しても、検査の記録の行に指摘の件数が残り、pace: fast のトリガーの閾値を見直す材料に使える状態にする

前提

• 前提 1: プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の仕組みは未実装である。git ls-tree -r --name-only origin/develop plugins/ndf/scripts/lib に ref_kinds を含むパスは 0 件（2026-11-06、origin/develop は 742ef62）。PR プランの参照: プランを作り直さずに版・記録の PR を流す直前の値で使い、承認時の値と食い違えば止まる（#2344） #2482 の本文は「この PR は文書だけを変更します」と書く。プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 と、その実装の前提になる 内部データに型と版を持たせ、同じ意味の値を 1 つの名前にそろえる #2339・入口の引数・環境変数・設定の受け取り方を 1 つの読み込み部品にそろえる #2341・実行の持ち主と後片付けを核に持たせ、残骸と並行の衝突で止まらないようにする #2342 はいずれも OPEN である。したがって、この課題は今の差し込みの処理（supervise_lib/queue.py・supervise_lib/queue_fill.py）へ足す
• 前提 2: プランに {queue_prs} が使われる経路は、昇格の record（delivery_templates.py:101）、本番の配布（release_templates.py:351）、承認ゲート 2 のプラン（sprint_routes.py:146）、配布の依頼（sprint.py:70）である。解決は差し込みの処理の中で行うため、どの経路にも同じ規則が効く
• 前提 3: プランの 課題 の欄は開発ループでも保たれる（carul の 5-promote.json は [110, 114, 102]）
• 前提 4: 既にある検査の記録の行と、この変更より前の進捗ログは書き換えない。過去の行の件数は null のままである

対象範囲

含む:

• {queue_prs} の差し込みの取り先を、今の queue の items と計画の課題を閉じる PR の和にすること
• 差し込みが queue の先頭のステージと、supervise.py run でも働くこと
• 置き換わらずに残った {queue_prs} を、コマンドを打たずに止めること
• ステップの件数を実行をまたいで読める形で残し、検査の記録の行へ写すこと
• plan.py の説明と、docs/specifications/ のうち差し込みの規則を書いた箇所の更新

含まない:

• プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の参照の仕組み（refs・{ref:<名前>}）の実装と、その範囲を広げること
• 問いの当て先と再開の位置（carul の根本原因 B-2: 問いの当て先と再開の位置を、今の周回の外から参照で解決する #2664）、次の周回の設計の起点（carul の根本原因 B-3: 次の周回の設計の起点を、設計 PR の状態から決める #2665）
• 単独の queue の pace: fast で、MVV 判定を打たずに承認ゲートへ落とす扱い（development-workflow の references/pace.md）の見直し
• {queue_prs:<名>} の差し込みの変更
• 過去の検査の記録の行を埋め直すこと
• {queue_pr:<名>}・{queue_state:<名>}・{queue_record} を run で解決すること（今と同じく、残っていれば止まる）

ドメインイベント

用語

受け入れ条件

差し込みの値:

• 1. 前提: 計画の 課題 が docs: Codex と Kiro の発動実測を単独条件で完了させる #110・Docs: cross-refactoring の実施計画と CLI 実機検証、Skill 一覧の計測修正 #114・feat: 全 Skill の description を新書式へ圧縮する（平均 237 → 150 文字） #102 で、それらを閉じる PR が Task 3: ndf の統合が前提とする 3 つの仕様を実測する #143 である（GitHub の読み出しはテストで差し替える）。操作: {queue_prs} を持つ昇格のプランだけのステージを queue で流す。結果: record のコマンドの引数が --prs 143 になり、終了コード 2 で落ちない
• 2. 1 と同じ前提で、supervise.py run <プラン> --from verify で流すと、record のコマンドの引数が --prs 143 になる
• 3. 1 か 2 の後に、同じ課題のまとめのプランの {queue_record} が、そのリリース記録を置いた PR の番号で埋まる
• 4. {queue_prs} を持つプランで、集合が空か GitHub を読めないとき、queue はそのプランを流さず、項目に 流さなかった・unfilled: true・理由を残す。run は最初のステップを打たずに stopped で返る。理由は、空か読めないかを区別する
• 5. 前のステージの PR と課題を閉じる PR が重なるとき、--prs の値は重ねず番号の昇順である。前のステージの PR が release: 配布物をプラグインごとの単一ディレクトリへ統合する（ndf v9.0.0） #140・Task 3: ndf の統合が前提とする 3 つの仕様を実測する #143 で閉じる PR が Task 3: ndf の統合が前提とする 3 つの仕様を実測する #143 なら 140 143 になる
• 6. それでも {queue_prs} が残ったコマンドのステップは、run でも queue でもコマンドを打たずに止まる
• 7. 実行の条件 を持つプランは、集合が空でも止めず、今と同じく条件に判断を任せる（退行しない）。
  前提の確認: pytest plugins/ndf/scripts/tests/test_supervise.py -k "queue_then or prs_from_queue" → 4 件通過（2026-11-06）。空の集合で流す分岐は queue.py:96-102 で読み、対応するテストの有無は未確認のため、この課題で足す

検査の件数:

• 8. 前提: 1 回目の実行の review が件数（rounds 4・fixed 8）を持って終了コード 6 で終わった。操作: --from base-sync で流し直し、record まで終える。結果: 検査の記録の行の findings の rounds が 4、fixed が 8 である
• 9. 同じステップが 2 回の実行で件数を持つとき（1 回目 fixed 3、2 回目 fixed 5）、行の値は最後の実行の 5 である
• 10. 頭から流し直した実行では、その実行より前の件数を読まない。頭からの実行で review が件数を持たなければ、行に fixed は無い
• 11. 進捗ログが無い・読めない行を含むときも record は落ちず、読めない項目は今と同じく null である（退行しない）
• 12. 1 回の実行だけの検査の行は、今と同じ findings になる（退行しない）。
  前提の確認: plugins/ndf/scripts/tests/ の findings_of のテスト（test_findings_copy_unconfirmed_of_a_refactor_step_that_did_not_pass_the_final_gate ほか）を実装の前後で通す

確かめと記録:

• 13. 1〜12 の条件ごとに、それを縛るテストがある
• 14. 昇格だけの周回で、昇格のプランの record が {queue_prs} を置き換えずに落ち、まとめのプランが流されない #2568・検査のプランを途中から流し直すと、検査の記録の行に前の実行のレビューの件数が入らず、stats の findings が null になる #2569 の再現の手順を 1 回ずつ通し、消えたものは理由を添えて閉じ、残ったものは理由をその課題の本文に書く

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

関連

親: #2648。同じ形: #2344

進行

モード: —

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

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

• 判定: unknown（承認ゲート 1）
• 理由: 判定を読めない
• 根拠の項目: —
• 設計 Pull Request: 差し込みの値と検査の件数: 昇格だけの周回と途中からの流し直しでも、記録が欠けずに残る（#2663） #2669
• 答え: approved
• 答え方: python3 /work/ai-plugins/plugins/ndf/scripts/sprint-state.py loop answer lcarul2 2663 --approved|--rejected|--revise --note <指摘ファイル>