carul の根本原因 B-2: 問いの当て先と再開の位置を、今の周回の外から参照で解決する #2664

具体例

配布待ちの周回を締め直すまとめの途中で区分つきの問いを出すと、loop hold-question は「進行中の周回が無い」で断り、答えを当てる場所が無くなる（#2638）。queue --resume --from はステップ名だけで照合するのでフルパスを断り（#2639 の 1 つ目）、強制終了した前の起動が残っていると無視して前の途中のステップから続ける（#2325）。

依頼（原文）

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

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

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

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

#2648（束 B）のうち、問いの当て先と再開の位置を、今の周回・今の起動の中の値でなく参照で解決する。

値	今の取り方	直す先
問いの当て先	進行中の周回だけ（lib/sprint_loop.py:546-556 cmd_hold_question。締め直しの cmd_finish の途中は進行中でない）	保留中も含むその周回を引く
再開の位置	名前の照合と前の起動の途中のステップ（supervise_lib/queue_resume.py:85）	耐久の記録の完了済みと指定の位置から決める

1. 配布待ちの周回の締め直しの途中で出した問いを loop hold-question が受け付け、答えの後に止まったステップから続く
2. --from にフルパスを渡しても再開でき、前の起動が残っていても指定が効く
3. 取り込み済み・完了済みのプランを流し直さない（queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349）
4. 問いの答えで再開するとき、答えの中身を読んでから流す（開発ループ: 問いの答えで再開するとき、答えの中身を読まずに止まったプランを流す #2466）
5. 1〜4 をそれぞれ縛るテストがある
6. 開発ループ: 保留の周回を締め直す途中で出た問いを loop hold-question が「進行中の周回が無い」で断り、答えを当てる場所が無くなる #2638・queue --resume の --from がフルパスを断り、再開したキューが配布の依頼の関門で 10 を返して loop lap が打たれない #2639・queue --resume の --from が、強制終了した前の起動が残っていると無視され、前の途中のステップから続く #2325・queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349・開発ループ: 問いの答えで再開するとき、答えの中身を読まずに止まったプランを流す #2466 の再現の手順を 1 回ずつ通し、消えたものは理由を添えて閉じ、残ったものは理由を本文に書く

#2639 の 2 つ目（配布の依頼の関門で queue --resume が 10 を返し、pipeline の && が loop lap を打たない）は結果の契約の問題で、#2337 に残す。

（書き手: 起票者、日付: 2026-11-06。本文の書き方と、#2648 の分割の節から、起票した AI の文と判断した）

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

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

解釈: 利用者が求めているのは、周回の問題を 1 件ずつでなく根本原因で直すことである。この課題が受け持つのは、「今の周回・今の起動」の中の値しか見ないため、保留の周回の締め直しとキューの続きで、問いが当たらず、再開の位置が食い違う経路である。

起票者の推定

題・本文のうち、利用者の原文に無く起票者が推して足した条件と、この要求を書いた AI が問わずに選んだ案。承認ゲート 1 で利用者が確かめるまで、利用者の決定として扱わない。

調べた事実

2026-11-06、ブランチ design/issue-2664（起点 v10.27.33-dev.1）で確かめた。

目的

• 保留の周回の締め直しの途中に出した問いが必ず周回の記録へ当たり、答えの後に止まった所から続く状態にする
• キューの続きの開始の位置が、指定と耐久の記録だけで決まり、渡し方や前の起動の残り方で変わらない状態にする
• 答えの中身を読まずに止まったプランを流す経路を無くす
• 達成したい状態: carul と ai-plugins で起きた 5 件（開発ループ: 保留の周回を締め直す途中で出た問いを loop hold-question が「進行中の周回が無い」で断り、答えを当てる場所が無くなる #2638・queue --resume の --from がフルパスを断り、再開したキューが配布の依頼の関門で 10 を返して loop lap が打たれない #2639 の 1 つ目・queue --resume の --from が、強制終了した前の起動が残っていると無視され、前の途中のステップから続く #2325・queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349 の 2 件・開発ループ: 問いの答えで再開するとき、答えの中身を読まずに止まったプランを流す #2466）の手当て（手で締め直す・耐久ワークフローを手で取り消す）が要らない

前提

• 前提 1: 実行の持ち主と後片付けを核に持たせ、残骸と並行の衝突で止まらないようにする #2342（持ち主の記録）と プランは値でなく参照を持ち、実行の直前に解決して照合する #2344（プランの参照）の実装を待たず、今のコード（supervise_lib/ と lib/sprint_loop*.py）の上で直す。両方の設計が先行の柱のマージを待っているためである。実行の持ち主と後片付けを核に持たせ、残骸と並行の衝突で止まらないようにする #2342 の決定 5 と プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の決定 8 の形に合わせ、後の実装が同じ箇所を重ねて直さなくてよいように、この課題のマージの後に両方の課題の本文へ「この課題が先に入れた範囲」を書く
• 前提 2: --from の指定は人か conductor の明示の指示である。完了したプランへ --from を渡したときは、実行条件に当たらなければ、今と同じく指定のステップから流す
• 前提 3: 答えの result のうち「続けない」と機械が読むのは rejected と revise だけである。approved と answered の中身（choice・note）は持ち主の AI が読む
• 前提 4: 同じ周回の締め直しの途中の問いは、配布待ちの周回でも質問待ちの周回でも同じ扱いである。1 つの周回に問いが 2 回以上当たることがある
• 前提 5: 実行条件の評価を足すのはキューの続きで開始のステップを持つプランに限る。承認ゲート 2 の承認の後の続き（supervise.py run <プラン> --from <ステップ>）と質問待ちの続きは今と同じく打たない。どちらもすでに条件を通ったプランの途中で、この時点で「変更が無い」と判定されると承認した配布が飛ぶためである

対象範囲

含む:

• loop hold-question が締め直しの途中の周回を引くこと、質問待ちへ戻すこと、遅れて届いた loop finish を受けないこと
• 質問待ちの続きが、止まったプランを 2 度流さず、同じキューの残りとまとめを流すこと
• 周回の秒が、配布待ちと質問待ちの両方の区間を数えること
• queue --resume --from の照合（名前・フルパス）と、断る文
• --from があるときに前の途中を子ごと止めて新しい実行の回で流すこと。止めたキューの他のプランの開始の位置を保つこと
• キューの続きでの実行条件の評価、完了したプランを流さないこと、完了の後に変わったプランを知らせて止まること
• 質問待ちの答えの読み取り、答えの記録、続けないときの締め方、持ち主への渡し方（references/loop.md の手順 2' の契約）
• 開発ループ: 保留の周回を締め直す途中で出た問いを loop hold-question が「進行中の周回が無い」で断り、答えを当てる場所が無くなる #2638・queue --resume の --from がフルパスを断り、再開したキューが配布の依頼の関門で 10 を返して loop lap が打たれない #2639・queue --resume の --from が、強制終了した前の起動が残っていると無視され、前の途中のステップから続く #2325・queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349・開発ループ: 問いの答えで再開するとき、答えの中身を読まずに止まったプランを流す #2466 の再現の手順を 1 回ずつ通し、閉じるか残すかを記録すること

含まない:

• queue --resume の --from がフルパスを断り、再開したキューが配布の依頼の関門で 10 を返して loop lap が打たれない #2639 の 2 つ目（配布の依頼で止まったときの終了コード）。結果の契約をそろえ、失敗・未収束・判定できないを ok で返す経路を無くす #2337 に残す
• queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349 の 3 つ目（差分の無い pr が終了コード 1 で止まる）。結果の契約の問題で、プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 も範囲から外している。queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349 は開いたまま残し、残す理由を本文に書く
• プランの差し込みの値と検査の件数（carul の根本原因 B-1: プランの差し込みの値と検査の件数を、今の起動の外から参照で解決する #2663）、次の周回の設計の起点（carul の根本原因 B-3: 次の周回の設計の起点を、設計 PR の状態から決める #2665）
• 再開のエントリポイントの新設（supervise.py resume）と、持ち主の記録（実行の持ち主と後片付けを核に持たせ、残骸と並行の衝突で止まらないようにする #2342）
• プランの型で読んだ中身の正規化（プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の決定 7）。この課題の「中身が変わった」はプランのファイルの中身で判定する
• 解決した値をプランのファイルへ書き戻さないこと（プランは値でなく参照を持ち、実行の直前に解決して照合する #2344 の起票者の推定 S6）
• 並列の計画のオーガナイザー側の問いの一覧・答えの送り方
• レーンでない 1 スプリントの問いの扱い

ドメインイベント

洗い出しで移したもの: E4 の当たる周回の選び方は受け入れ条件 2 に、E5 は受け入れ条件 4 に、E11 の 3 つの分かれ方は受け入れ条件 10〜12 に置いた。E7 の持ち主の判断の手段は未決に置いた。

用語

受け入れ条件

問いの当て先

• 1. 配布待ちの周回の締め直しの途中で loop hold-question を打つと、受け付けて ok を返し、周回の結果が質問待ちになり、question に依頼の id・止まったプラン・ステップが入り、release の答えと本番の版が残る
• 2. 進行中の周回と締め直しの途中の周回が同時にあるとき、hold-question は --plan のプランが属する周回へ当たる。どの周回にも当たらないときは断り、周回の記録は変わらない（stopped。理由に周回が見つからないことと渡した --plan が出る）
• 3. 1 の問いの答えの後、止まったプランが指定のステップから 1 回だけ流れ、残りのステージとまとめが流れて周回が締め直される。止まったプランがまとめの中にあっても、頭からもう 1 度流れない
• 4. 質問待ちへ戻した周回に、戻す前に流れていた pipeline の loop finish が届くと断り、周回は質問待ちのままで、問いの答えを当てられる
• 5. 締め直しの途中で問いが当たった周回の秒は、配布待ちの区間と質問待ちの区間の両方を足し、答えを待っていた時間を足さない

再開の位置

• 6. queue --resume <done> --from <プラン>=<ステップ> の <プラン> に、一覧の stages に載ったフルパスと、同じファイルを指す相対パスを渡すと、ファイル名を渡したときと同じプランを同じステップから流す
• 7. どのプランにも当たらないときは何も流さずに stopped を返し、断る文に「名前かフルパスで渡す」ことが出る
• 8. 前の起動が強制終了で途中のまま残っていても、--from があれば、前の途中の耐久ワークフローを子ごと止め、指定のステップから新しい実行の回で流す。止められなければ何も流さず stopped を返す
• 9. 8 のとき、--from の対象でないプランのうち、完了したものは流れず、途中だったものは頭からでなく終えたステップから続く
• 10. キューの続きで開始のステップを持つプランの実行条件が飛ばす条件に当たると、そのプランは流れず、結果は 完了 で、理由に実行条件に当たらないことが出る
• 11. 完了したプランを含む done を --from なしで --resume すると、完了したプランは流れず、記録した結果を返す
• 12. 完了の後にプランのファイルが変わっていて --from が無いとき、そのプランは流れず、queue --resume は gate（終了コード 10 番台）で返り、変わったプランと、流し直す手段（--from）が結果に出る

答えの中身

• 13. 質問待ちの周回に rejected か revise の答えが届くと、止まったプランは流れず（pipeline が空）、周回は「人へ戻した」で締まる
• 14. 質問待ちの周回に approved か answered の答えが届くと、loop select と loop pending は status: finish と今の形の pipeline に加えて、metrics.answer に result・choice・note を返す
• 15. 持ち主が答えの中身を読んで続けないと決めたとき、止まったプランを流さずに周回を「人へ戻した」で締める手段が 1 つある
• 16. どの答えでも、答えの中身（result・choice・note・読んだ時刻）が周回の question に残り、loop status か loop.json から読める

テストと確かめ

• 17. 受け入れ条件 1〜16 をそれぞれ縛るテストがある
• 18. 開発ループ: 保留の周回を締め直す途中で出た問いを loop hold-question が「進行中の周回が無い」で断り、答えを当てる場所が無くなる #2638・queue --resume の --from がフルパスを断り、再開したキューが配布の依頼の関門で 10 を返して loop lap が打たれない #2639・queue --resume の --from が、強制終了した前の起動が残っていると無視され、前の途中のステップから続く #2325・queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349・開発ループ: 問いの答えで再開するとき、答えの中身を読まずに止まったプランを流す #2466 の再現の手順を、直した版のスクリプトで 1 回ずつ通す。消えたものは理由を添えて閉じ、残ったもの（queue --resume の --from がフルパスを断り、再開したキューが配布の依頼の関門で 10 を返して loop lap が打たれない #2639 の 2 つ目・queue の再開が、取り込み済み・完了済みの実装のプランを流し直し、差分なしの PR 作成で止まる #2349 の 3 つ目を含む）は理由を各課題の本文に書く

起きてはいけないこと

• 19. 進行中の周回への hold-question は、今と同じく周回を質問待ちで締め、答えの後に止まったプランを指定のステップから流す（退行しない）
  前提の確認: uv run --frozen --project . --all-extras pytest plugins/ndf/scripts/tests/test_sprint_loop.py -q -n 4 の test_hold_question_closes_the_lap_and_the_answer_resumes_the_stopped_plan → 通過（2026-11-06、v10.27.33-dev.1）
• 20. --from の無い queue の打ち直しは、今と同じく落ちた前の起動を続け、済んだステップを流し直さない（退行しない）
  前提の確認: uv run --frozen --project . --all-extras pytest plugins/ndf/scripts/tests/test_supervise_queue.py -q -n 4 -k killed_queue_continues_from_the_running_step → 1 passed（2026-11-06）
• 21. --from の名前の照合（ファイル名と末尾の一致）と、{queue_pr:<名>}・前提のプランの照合の結果が変わらない（退行しない）
  前提の確認: tests/test_supervise_queue_continue.py の test_resume_with_from_and_without_a_listing → 通過（2026-11-06）
• 22. 承認ゲート 2 の承認の後の続き（run --from）は、実行条件で飛ばされない（前提 5。退行しない）
  前提の確認: supervise_lib/engine.py:219 の読み取り（開始のステップがあると打たない）。設計の前にテストで固定する
• 23. 配布待ちの周回の released の答えの後の流れ（rejected・失敗の答えの締め方を含む）は変わらない（退行しない）
  前提の確認: tests/test_sprint_loop.py → 通過（2026-11-06）
• 24. 全体テスト uv run --frozen --project . --all-extras pytest . -q -n 4 が、マージの前後で通る

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

関連

親: #2648。再開: #2342。参照: #2344。対象の課題: #2638・#2639・#2325・#2349・#2466

進行

モード: —

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

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

• 判定: unknown（承認ゲート 1）
• 理由: 判定を読めない
• 根拠の項目: —
• 設計 Pull Request: 開発ループとキューの続き: 保留の周回の問いが必ず当たり、再開の位置が指定と耐久の記録だけで決まる（#2664） #2694
• 答え: approved
• 答え方: python3 /persistent/ai/.claude/plugins/cache/ai-plugins/ndf/10.27.31/scripts/sprint-state.py loop answer lcarul2 2664 --approved|--rejected|--revise --note <指摘ファイル>