開発ワークフローに「見直し」と「大整理」を足す: 棚卸しを毎スプリントの差分の棚卸し・数回に 1 回の見直し・十数回に 1 回の大整理（根本原因の発見と組み直し、後回しの再評価）に分ける #2315

依頼（原文）

ただ、このフェーズはsprintの終わりに毎回実行、では重すぎる気もします。

ただ、棚卸については、バージョンアップに伴う既存issueの追従は毎sprint、優先順位の再評価、順位付け、マイルストーン再編、枝刈りは数回に一回など、グラデーションが必要かもしれません。

（書き手: 利用者、日付: 2026-11-01 JST。依頼の全文と、ほかの 3 つの原文は確定仕様 https://github.com/devbasex/ai-plugins/blob/develop/docs/specifications/ndf-backlog-refinement-depths.md の元になった要求の写し（コミット 8d72be3 の issues/issue-2315-requirements.md）にある）

この課題の残りは、上の「重すぎる」に対して、毎スプリントの棚卸しが実際に軽くなったかを確かめる 1 点である。棚卸しの 3 つの深さ（差分の棚卸し・見直し・大整理）は ndf v10.27.14 で配布し、受け入れ条件 17 を除く起票時の条件は、その配布と確定仕様の「テスト観点」が持つ。確かめたこと（2026-11-04、origin/develop 7476a08）: pytest で test_upkeep_depth*・test_upkeep_owner*・test_upkeep_overhaul* が 30 件合格。

起票者の推定

目的

• 毎スプリントの棚卸し（差分の棚卸し）の所要を、3 つの深さに分ける前より短くし、短くなったことを深さの記録で示す

今の状態（実測）

変更の後も、差分の棚卸しは分ける前より長い。 このリポジトリのメインディレクトリのプランの進行の記録（.ndf/loop/*/lap-*/close*/*-state/progress.jsonl）の、refine のステップの行を数えた。

（終了コードが 0 でない行と、同じ周回のやり直しの行は除いた。集計のコマンドは grep '"step": "refine",' <progress.jsonl> | grep '"kind": "step"' の seconds・cost）

深さの記録には、比べる値がまだ残っていない。 まとめのプランの深さの記録のステップ（refine-record）は、ndf v10.27.24（コミット ea73a7d）からプランの進行の記録（--progress）を受け取り、棚卸しのステップの秒・ドルと開発ループ・周回を写す（plugins/ndf/scripts/supervise_lib/sprint_close_steps.py の 185 行目）。2026-11-06 07:15 JST 時点の .ndf/backlog/depths.jsonl の差分の棚卸しの行は 8 件で、cost・seconds・loop・lap はどれも null である。v10.27.24 のタグのコミットの時刻（2026-11-05 19:11 UTC）より後の行は 4 件（スプリント lfactory3-8・lflow2-9・lroot3-14・lroot3-17）で、v10.27.24 を導入する前に作ったプランが書いた行か、写す処理が働いていないかは未確認。2026-11-05 22:17 UTC のスプリント lfactory3-10 の差分の棚卸しの行は、seconds 208.3・cost 1.733・loop lfactory3・lap 10 を持ち、値が写った最初の 1 件である（基準の下端 206 秒・1.41 ドルをどちらも下回らない）。

見積の段階を付ける課題は、そのスプリントで起票した課題に絞られた。 ndf v10.27.24（コミット 4d31771 ほか）から、差分の棚卸しの候補の収集は unscored の経路を --since-ref のコミットの時刻より後に作られた課題に限り、rank も同じ --since-ref を受けて、それより前に作られた見積の無い課題を見直しへ回す（metrics.left_for_review）。スプリント lfactory3-10 の差分の棚卸し（2026-11-06）では unscored の経路は 0 件だった（upkeep.py candidates --since-ref ndf--v10.27.25 --depth diff の metrics.by_route.unscored）。

前提

• 前提 1: 「今より短い」は、今の範囲（206〜224 秒・1.41〜1.61 ドル）の下端を下回ることとする。1 回ごとのばらつきが大きいため、変更の後の差分の棚卸し 3 回の中央値で比べる
• 前提 2: 比べるのはこのリポジトリ（ai-plugins）のメインディレクトリの周回だけである。並行して動く別の開発ループの周回も数に入れる
• 前提 3: 差分の棚卸しを担う言語モデルは、基準の 2 回と同じ claude-opus-5-5 とする。モデルが変わった周回は比べる 3 回に入れない
• 前提 4: 1 回の候補の上限（既定 10 件）は変えない。上限を下げて所要を縮めることは、この課題の達成として数えない

対象範囲

含む:

• 差分の棚卸しの所要を縮めること（何を削るか・どう縮めるかは設計で決める）
• 差分の棚卸しの行に、そのステップの秒・ドルと、開発ループ・周回を残すこと
• 差分の棚卸しの見積の段階の付与を、SKILL.md の定めどおりそのスプリントで起票した課題に揃えること

含まない:

• 見直しと大整理の所要と、その費用と秒の上限（棚卸しの見直しのステップに費用と秒の上限が効かない #2423 が持つ）
• 1 回の候補の上限の値の変更（前提 4）
• 過去の周回の深さの記録を書き直すこと（比べる 3 回は、変更の後に新しく書かれた行から取る）

ドメインイベント

E3 の失敗の経路（秒・ドルが読めないときに行を欠かすか null で書くか）は受け入れ条件 17b-3 に移した。

用語

受け入れ条件

• 17. このリポジトリで、毎スプリントの棚卸しの所要（秒・ドル）が今（開発ループ l20261031 の周回 2・3 の refine のステップで 206〜224 秒・1.41〜1.61 ドル）より短くなったことを、変更の後の周回の記録で示す
  • 17a. 変更を配布した後の差分の棚卸しの行 3 件（深さの記録の depth が diff・event が ran）で、seconds の中央値が 206 未満、cost の中央値が 1.41 未満である
  • 17b-1. まとめのプランで差分の棚卸しを通すと、深さの記録の差分の棚卸しの行の seconds・cost が、同じプランの進行の記録の refine の行の seconds・cost と一致する
  • 17b-2. 同じ行の loop・lap が、そのプランを起動した開発ループの名前と周回の番号になる（開発ループの外で人が起動したプランでは null）
  • 17b-3. プランの進行の記録に refine の行が無いとき（ステップが打ち切られたなど）も、差分の棚卸しの行は書かれ、seconds・cost は null になる
  • 17c. 差分の棚卸しの候補（candidates --depth diff）に unscored の経路で入る課題は、前の正式版のタグの時刻より後に作られた課題だけである。見直し（--depth review）の候補の集め方は変わらない
  • 17d. 差分の棚卸しの行の中央値の比べ方（3 件そろったか・中央値・基準との差）を、コマンド 1 本で深さの記録から出せる。3 件に満たなければ、そろった件数を返して判定を保留する

非機能の条件

影響

検証手段

前提とする取り決め

境界

未決

関連: #2423（棚卸しの見直しのステップに費用と秒の上限が効かない）

進行

モード: — / 進め方: auto

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

振り返り: #2426 (comment)

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

• 判定: unknown（承認ゲート 1）
• 理由: 設計の中身は MVV に沿っている。見積の段階を付ける課題を、そのスプリントで作られた課題に絞って所要を縮める（Value 3）。秒・ドルを実測で記録し、比べ方を 1 本のコマンドにする（Value 4・Value 5）。基準の値と件数は引数で受け、既定に埋め込まない（Value 6）。起点の時刻を候補の収集と同じものにそろえる（Value 7）。配布の後の 3 回の中央値は配布前に測れないため、判定の対象にしていない／要求のコピーの照合（requirements-check）が終了コード 2 で止まり、issues/issue-2315-requirements.md を読めていない。原因は未確認とされている。このため、要求と受け入れ条件のコピーが 開発ワークフローに「見直し」と「大整理」を足す: 棚卸しを毎スプリントの差分の棚卸し・数回に 1 回の見直し・十数回に 1 回の大整理（根本原因の発見と組み直し、後回しの再評価）に分ける #2315 の本文と一致するかを材料から確かめられない。確かめていないものを済んだと扱わない原則（Value 1）と、AI が決められないときは人へ戻す決まり（Value 2）に照らすと、自動で関門を通せない／承認資料の数字が食い違っている。PR 本文の変更統計（glossary.md +2 -2・glossary.json +14 -0・設計文書 +317）と、変更したファイルの一覧（+3 -1・+13 -1・+320）が合わない。本文が古いまま残っている可能性があり、承認資料の正しさ（Value 3・Value 8）を確かめられない／共通原則 C1〜C8 と固有の P1 に当たる操作は見当たらない。用語集と issues/ の文書は .ndf/ でも CLAUDE.md の運用の節でもない。深さの記録（.ndf/backlog/depths.jsonl）はスクリプトが行を足す記録で、この PR では利用者の設定を書き換えない
• 根拠の項目: Mission, Vision, Value 1, Value 2, Value 3, Value 4, Value 5, Value 6, Value 7, Value 8, C7, P1
• 設計 Pull Request: 差分の棚卸し: 見積の段階をそのスプリントの課題だけに付け、縮んだ所要をコマンド 1 本で確かめる（#2315） #2526
• 答え: approved
• 答え方: python3 /work/ai-plugins/plugins/ndf/scripts/sprint-state.py loop answer lflow2 2315 --approved|--rejected|--revise --note <指摘ファイル>