docs: docs/ 一時作業文書の全件棚卸し — 期限判定 5 件確定・計画書 3 本削除・台帳整理 + weekly reminder 7 日差し戻し - #392
Conversation
|
Important Review skippedAuto incremental reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
📝 WalkthroughWalkthroughリマインダー、品質ゲート、ADR、開発規約、計画書、TODO台帳を更新しました。採用済み仕様、削除済み計画、default-ON設定、2026-08-12時点の運用記録を各文書へ反映しました。 Changes運用仕様と文書台帳
Estimated code review effort: 4 (Complex) | ~45 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
🤖 PR Monitor 分析 (GitHub Actions バックストップ)
Applicable Findings (Critical / High / Major)(該当なし — レビュー指摘が未着) Applicable Findings (Medium 以下)(該当なし) Filtered (not applicable)(該当なし) 次のアクション
|
There was a problem hiding this comment.
Actionable comments posted: 14
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/adr/adr-030-deterministic-post-merge-feedback.md`:
- Around line 454-464: 本文全体でPhase E撤回後の方針に統一し、冒頭の「Supersedes
ADR-014/029」およびPhase Eで「Superseded by
ADR-030」に更新する記述を、撤回前の計画であると明記するか現行方針に合わせて修正してください。ADR-014/029を「試験運用」のまま維持し、本ADRと旧機構を併存させる現行状態が一貫して読めるよう、関連するPhase
E記述も更新してください。
In `@docs/adr/adr-043-security-gates-fail-closed.md`:
- Around line 149-157: Amend the “判定根拠” section so the NO-GO decision does not
treat the recorded zero gate FAILs as the actual count. In the third rationale,
explicitly base the decision on the inability to verify the GO threshold and the
incompatibility of the current architecture, or define an explicit
unknown/unobservable result as a NO-GO condition; remove the claim that the
recorded 0–1 count formally satisfies the threshold.
In `@docs/adr/adr-045-jj-workspace-parallel-sessions.md`:
- Line 13: ADR-045 のメインセッション担当記述から、削除済みの file-length-enforcement-plan.md に基づく
W3/W4 を進行中の作業として扱わないよう更新してください。冒頭の計画説明と、メイン workspace の担当を示す箇所の両方で、W3/W4
は完了済みの履歴として整理するか、現在の担当領域へ置き換えてください。
In `@docs/adr/adr-056-review-policy-anomaly-shadow.md`:
- Around line 268-283: 「確定判定」節の telemetry 母集団を canonical corpus として統一し、212
record・214 run・207 run の関係を整理してください。対象期間、フィルター、除外条件を明記したうえで、速度統計と REJECT
分子・分母を同じ母集団から再計算し、docs/push-pipeline-fix-plan2.md の 212 record 記載とも整合させてください。
In `@docs/adr/adr-057-docs-only-deterministic-routing.md`:
- Line 5: ADR内の採用済み状態と試験中状態の混在を解消してください。`決定 (試験運用)` の見出しと bounded-lifetime
節を、2026-08-12 の採用判定および templates の default-ON
昇格を反映した「採用判定済み」の内容へ更新してください。2026-08-15 の将来判定や試験中の条件は削除せず、履歴として残してください。
In `@docs/adr/adr-059-hook-system-message-visibility.md`:
- Around line 5-13:
ADR-059内の採用確定日と矛盾する旧dogfood記述を整理してください。判定期限を2026-08-16とする記述および計画書を保持して調査する記述を削除するか、過去の履歴であることを明示し、冒頭と「確定判定」節を含む本文全体で2026-08-12の採用確定と関連資料・調査の削除に統一してください。
In `@docs/dev-conventions.md`:
- Around line 115-123: 開発手順の rebase 基準をローカルの master ではなく、jj rebase コマンドの宛先として
master@origin に統一してください。ADR-013 および ADR-045 と同じ基準を使い、jj git fetch 後も stale なローカル
bookmark に依存しないよう更新してください。
In `@docs/insights-followup-plan.md`:
- Line 3: docs/insights-followup-plan.md の位置づけ記述から個人環境の絶対パス C:\Users\owner\...
を削除し、<USERPROFILE>\.claude\usage-data\...
などの環境非依存なプレースホルダーまたはリポジトリ相対表現に置き換えてください。
In `@docs/push-pipeline-fix-plan2.md`:
- Line 148: R3の状態記録を同一時点の情報に統一してください。見出しと、R3の「マージ済み
`#294`」、実装・push状況、実データ件数の記述を、2026-08-12時点のマージ済み・212
record蓄積済みという記録に合わせて更新するか、過去スナップショットとして残す場合は対象時点を明記してください。R5/R6の判定データと矛盾しない内容にしてください。
In `@docs/takt-step-timings.md`:
- Around line 15-18: Update the --until explanation around the ADR-047/056
deadline note on Line 26 to reflect that both ADR decisions are already
finalized as of 2026-08-12; remove the outdated “until the decisions are
finalized” condition while preserving the existing --until usage guidance.
In `@docs/todo.md`:
- Line 5: 統一された TODO preamble に更新してください。docs/todo.md の 5-5 行目と docs/todo11.md の
5-5 行目は確認範囲を todo3.md〜todo22.md に変更し、docs/todo10.md の 5-5 行目は新規詳細エントリの追加先を
docs/todo22.md に変更したうえで、現存ファイル範囲から todo2.md を除外してください。
In `@docs/todo11.md`:
- Line 5: docs/todo11.md の冒頭説明文で、確認対象から退役済みの todo2.md を除外し、列挙範囲を
docs/todo3.md〜docs/todo22.md
に更新してください。実際の対象ファイル数と一致するよう、記載する総数も現行範囲に合わせて修正してください。
In `@docs/todo3.md`:
- Line 5: 退役済みのtodo2.mdをTODO
preambleの列挙範囲から除外し、docs/todo3.mdの5行目とdocs/todo4.mdの5行目にあるtodo2-22.mdをtodo3-22.mdへ変更してください。23ファイルという件数と実際の列挙範囲が一致する状態を両ファイルで維持してください。
In `@docs/todo8.md`:
- Line 5: 更新されたTODOファイルの台帳と追加先を全サイトで一致させる。docs/todo8.md の preamble は追加先を
docs/todo22.md に変更し、確認対象を todo.md、todo3.md〜todo22.md、2つの
summary(23件)に修正する。docs/todo5.md、docs/todo6.md、docs/todo7.md、docs/todo9.md の各
preamble では todo2.md を対象範囲から除外し、退役済みであることを明記したうえで23件の一覧に更新する。
🪄 Autofix
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro Plus
Run ID: be1fb40f-48c3-46d0-9653-70e85b748b65
📒 Files selected for processing (46)
.claude/hooks-config.toml.takt/facets/instructions/file-length-watchlist.mdCLAUDE.mddocs/adr/adr-030-deterministic-post-merge-feedback.mddocs/adr/adr-033-todo-numbering-simplification.mddocs/adr/adr-043-security-gates-fail-closed.mddocs/adr/adr-045-jj-workspace-parallel-sessions.mddocs/adr/adr-056-review-policy-anomaly-shadow.mddocs/adr/adr-057-docs-only-deterministic-routing.mddocs/adr/adr-058-post-takt-regate.mddocs/adr/adr-059-hook-system-message-visibility.mddocs/auto-push-gate-dogfood.mddocs/bundle-history.mddocs/dev-conventions.mddocs/file-length-enforcement-plan.mddocs/harness-improvement-plan.mddocs/insights-followup-plan.mddocs/push-pipeline-fix-plan.mddocs/push-pipeline-fix-plan2.mddocs/takt-step-timings.mddocs/todo-summary.mddocs/todo-summary2.mddocs/todo.mddocs/todo10.mddocs/todo11.mddocs/todo13.mddocs/todo14.mddocs/todo17.mddocs/todo18.mddocs/todo19.mddocs/todo2.mddocs/todo22.mddocs/todo3.mddocs/todo4.mddocs/todo5.mddocs/todo6.mddocs/todo7.mddocs/todo8.mddocs/todo9.mddocs/weekly-review-notification-plan.mdpush-runner-config.tomlsrc/cli-push-runner/src/stages/docs_only_routing.rssrc/cli-push-runner/src/stages/post_takt_regate.rssrc/hooks-post-tool-comment-lint-rust/src/modified_files_check.rssrc/hooks-session-start/src/weekly_review.rstemplates/push-runner-config.toml
💤 Files with no reviewable changes (4)
- docs/auto-push-gate-dogfood.md
- docs/todo2.md
- docs/weekly-review-notification-plan.md
- docs/file-length-enforcement-plan.md
| - **Phase E**: 旧機構廃止 — **撤回 (2026-08-12、下記 § 撤回記録)** | ||
| - **Phase F**: dogfood 検証 — 長期運用実績で充足 (2026-08-12 判定、下記 § 撤回記録) | ||
|
|
||
| ### 撤回記録 (2026-08-12): Phase E (旧機構廃止) の撤回と Phase F の決着 | ||
|
|
||
| docs 棚卸しで Phase E の計画と実態の矛盾が顕在化したため、ユーザー判断で **Phase E を撤回**した。 | ||
|
|
||
| - **矛盾の内容**: Phase E は post-merge-feedback skill / `hooks-stop-feedback-dispatch` crate / `lib-pending-file` の削除と ADR-014/029 の Superseded 化を計画していたが、実態はこれらすべてが現在も稼働中 (skill は ADR-029 自動起動経路つきで deploy 済み、crate 2 つは `build:all` に配線、`.gitignore` の pending 行も現役)。稼働中の機構を計画どおり機械的に削除することはできず、かといって計画を放置すると「廃止予定」と「現役」の宣言が併存し続ける。 | ||
| - **判断**: 現行機構の稼働継続を正とし、廃止タスクを取り下げる。ADR-014 / ADR-029 のステータスは「試験運用」のまま維持し、本 ADR の L1/L2 と旧機構 (skill / hook 経路) は**併存構成が現行の正**である。本文中の「Phase E で実施」とある ADR-014/029 の Superseded 化も実施しない。 | ||
| - **Phase F の決着**: 専用の dogfood 検証は不要と判定。2026-04 の land 以降 3 か月超の運用で feedback report が全マージ PR で生成され続けており (`.claude/feedback-reports/` は #390 まで連続)、L1 Drop guard + L2 recovery (PR #154) も投入済み。silent loss 0 の実証は運用実績で充足した。 | ||
| - **台帳**: 該当 todo エントリ (todo.md) と priority table 行は 2026-08-12 に削除。派生プロジェクト反映タスクのみ任意タスクとして存続。 |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
Phase E撤回の状態を本文全体へ反映してください。
Lines 457-464 は、ADR-014 と ADR-029 のステータスを 試験運用 のまま維持し、旧機構と本 ADR を併存させると記録しています。一方、Lines 7-8 は Supersedes ADR-014 / Supersedes ADR-029 と記載し、Lines 370 と 378 は Phase E で Superseded by ADR-030 に更新すると記載しています。
現在方針を 1 つに統一してください。過去の計画を残す場合は、撤回前の履歴であることを明記してください。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/adr/adr-030-deterministic-post-merge-feedback.md` around lines 454 -
464, 本文全体でPhase E撤回後の方針に統一し、冒頭の「Supersedes ADR-014/029」およびPhase Eで「Superseded by
ADR-030」に更新する記述を、撤回前の計画であると明記するか現行方針に合わせて修正してください。ADR-014/029を「試験運用」のまま維持し、本ADRと旧機構を併存させる現行状態が一貫して読めるよう、関連するPhase
E記述も更新してください。
| ## Amendment (2026-08-12): auto-push gate は即 escalation 運用を恒久化 (B1-loop NO-GO) | ||
|
|
||
| PR #224 の auto-push gate-bypass 是正 (A1: fix.md の虚偽 `fully_resolved` 抑止 / B1: cli-pr-monitor `stages/gate.rs` の決定論 gate + FAIL 時即 escalation) の dogfood 観測 (2026-07-03〜08-12、`docs/auto-push-gate-dogfood.md`、本 amendment への転記をもって削除) に基づき、**B1-loop (gate FAIL 時の自動修復ループ) は実装しない (NO-GO)**。gate FAIL 時は即 escalation (人間へ引き継ぎ) を恒久運用とする。 | ||
|
|
||
| 判定根拠: | ||
|
|
||
| 1. **gate FAIL の観測記録が 6 週間で 1 件も取れなかった**。ただしこれは「FAIL が 0 件だった」ことを意味しない — cli-pr-monitor は lib-telemetry 未統合で、gate 結果 (`[gate] PASS/FAIL` / `[decision] gate:`) は stdout にしか出ず永続化されない。**観測手段の欠落**により GO 条件 (FAIL 2 件以上) の成立を立証できる経路が存在しなかった (この観測欠落自体の再発防止は「決定論 gate 結果の telemetry 統合」として todo 台帳へ起票済み)。 | ||
| 2. **前提経路の消滅**: WP-17 PR 3 (#353) の single-shot 化でローカル monitor プロセス内の auto-push 経路は縮退し、未確定 PR の後続処理は GitHub Actions 経路 (ADR-067 Phase B) へ移行済み。B1-loop の設計 (monitor プロセス内の同期反復) は現アーキテクチャと非整合。 | ||
| 3. NO-GO 基準「gate FAIL 0-1 件」に形式上該当し、ループの複雑さ (専用 workflow + 反復制御) に見合う需要の証跡がない。 |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
観測不能な件数を「0件」として NO-GO 判定しないでください。
Line 155 は、telemetry がないため gate FAIL の実数を判定できないと説明します。しかし Line 157 は、記録された FAIL が 0-1 件なので NO-GO 基準に形式上該当すると記載します。
「記録件数 0」は「実際の件数 0」ではありません。NO-GO の根拠を「観測不能で GO 条件を検証できない」「現アーキテクチャと非整合」と明記するか、unknown を明示的な NO-GO 条件として定義してください。
修正例
- NO-GO 基準「gate FAIL 0-1 件」に形式上該当し、
+ gate FAIL 件数は観測不能で GO 条件を検証できず、📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| ## Amendment (2026-08-12): auto-push gate は即 escalation 運用を恒久化 (B1-loop NO-GO) | |
| PR #224 の auto-push gate-bypass 是正 (A1: fix.md の虚偽 `fully_resolved` 抑止 / B1: cli-pr-monitor `stages/gate.rs` の決定論 gate + FAIL 時即 escalation) の dogfood 観測 (2026-07-03〜08-12、`docs/auto-push-gate-dogfood.md`、本 amendment への転記をもって削除) に基づき、**B1-loop (gate FAIL 時の自動修復ループ) は実装しない (NO-GO)**。gate FAIL 時は即 escalation (人間へ引き継ぎ) を恒久運用とする。 | |
| 判定根拠: | |
| 1. **gate FAIL の観測記録が 6 週間で 1 件も取れなかった**。ただしこれは「FAIL が 0 件だった」ことを意味しない — cli-pr-monitor は lib-telemetry 未統合で、gate 結果 (`[gate] PASS/FAIL` / `[decision] gate:`) は stdout にしか出ず永続化されない。**観測手段の欠落**により GO 条件 (FAIL 2 件以上) の成立を立証できる経路が存在しなかった (この観測欠落自体の再発防止は「決定論 gate 結果の telemetry 統合」として todo 台帳へ起票済み)。 | |
| 2. **前提経路の消滅**: WP-17 PR 3 (#353) の single-shot 化でローカル monitor プロセス内の auto-push 経路は縮退し、未確定 PR の後続処理は GitHub Actions 経路 (ADR-067 Phase B) へ移行済み。B1-loop の設計 (monitor プロセス内の同期反復) は現アーキテクチャと非整合。 | |
| 3. NO-GO 基準「gate FAIL 0-1 件」に形式上該当し、ループの複雑さ (専用 workflow + 反復制御) に見合う需要の証跡がない。 | |
| ## Amendment (2026-08-12): auto-push gate は即 escalation 運用を恒久化 (B1-loop NO-GO) | |
| PR #224 の auto-push gate-bypass 是正 (A1: fix.md の虚偽 `fully_resolved` 抑止 / B1: cli-pr-monitor `stages/gate.rs` の決定論 gate + FAIL 時即 escalation) の dogfood 観測 (2026-07-03〜08-12、`docs/auto-push-gate-dogfood.md`、本 amendment への転記をもって削除) に基づき、**B1-loop (gate FAIL 時の自動修復ループ) は実装しない (NO-GO)**。gate FAIL 時は即 escalation (人間へ引き継ぎ) を恒久運用とする。 | |
| 判定根拠: | |
| 1. **gate FAIL の観測記録が 6 週間で 1 件も取れなかった**。ただしこれは「FAIL が 0 件だった」ことを意味しない — cli-pr-monitor は lib-telemetry 未統合で、gate 結果 (`[gate] PASS/FAIL` / `[decision] gate:`) は stdout にしか出ず永続化されない。**観測手段の欠落**により GO 条件 (FAIL 2 件以上) の成立を立証できる経路が存在しなかった (この観測欠落自体の再発防止は「決定論 gate 結果の telemetry 統合」として todo 台帳へ起票済み)。 | |
| 2. **前提経路の消滅**: WP-17 PR 3 (#353) の single-shot 化でローカル monitor プロセス内の auto-push 経路は縮退し、未確定 PR の後続処理は GitHub Actions 経路 (ADR-067 Phase B) へ移行済み。B1-loop の設計 (monitor プロセス内の同期反復) は現アーキテクチャと非整合。 | |
| 3. gate FAIL 件数は観測不能で GO 条件を検証できず、ループの複雑さ (専用 workflow + 反復制御) に見合う需要の証跡がない。 |
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/adr/adr-043-security-gates-fail-closed.md` around lines 149 - 157, Amend
the “判定根拠” section so the NO-GO decision does not treat the recorded zero gate
FAILs as the actual count. In the third rationale, explicitly base the decision
on the inability to verify the GO threshold and the incompatibility of the
current architecture, or define an explicit unknown/unobservable result as a
NO-GO condition; remove the claim that the recorded 0–1 count formally satisfies
the threshold.
| ### 問題 | ||
|
|
||
| メインセッションは `docs/file-length-enforcement-plan.md` の W3 (cli-merge-pipeline 分割) / W4 (cli-push-runner 分割) という大規模 src リファクタを進める。一方で post-merge-feedback / 週次レビュー / CodeRabbit 対応から、`docs/todo*.md` 系列に細粒度の不具合修正・改善タスク (lint rule / takt facet / test / docs 系、順位 225-232 等) が継続的に蓄積している。 | ||
| メインセッションは `docs/file-length-enforcement-plan.md` (同計画は全 PR 完了により 2026-08-12 削除済み) の W3 (cli-merge-pipeline 分割) / W4 (cli-push-runner 分割) という大規模 src リファクタを進める。一方で post-merge-feedback / 週次レビュー / CodeRabbit 対応から、`docs/todo*.md` 系列に細粒度の不具合修正・改善タスク (lint rule / takt facet / test / docs 系、順位 225-232 等) が継続的に蓄積している。 |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
削除済み計画を進行中の作業として記録しないでください。
Line 13 は、file-length-enforcement-plan.md が全 PR 完了後に削除されたと記載します。同じ文で、W3/W4 を進行中として記載しています。Lines 105-108 も、メイン workspace の担当を削除済み計画の W3/W4 としています。
この記述は PR の完了記録および docs/dev-conventions.md と矛盾します。W3/W4 を履歴として記録するか、現在の担当領域へ更新してください。未更新のままでは、後続セッションが完了済みの分割作業を再開する可能性があります。
Also applies to: 105-108
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/adr/adr-045-jj-workspace-parallel-sessions.md` at line 13, ADR-045
のメインセッション担当記述から、削除済みの file-length-enforcement-plan.md に基づく W3/W4
を進行中の作業として扱わないよう更新してください。冒頭の計画説明と、メイン workspace の担当を示す箇所の両方で、W3/W4
は完了済みの履歴として整理するか、現在の担当領域へ置き換えてください。
| ## 確定判定 (2026-08-12): 採用 | ||
|
|
||
| push-runs telemetry 212 record (2026-07-18〜08-11) の集計に基づく確定判定 (2026-08-12)。 | ||
|
|
||
| ### 速度: 目標取り下げ | ||
|
|
||
| anomaly era 214 run で execute avg 169.5s / median 155.0s (checklist era: avg 162.6 / | ||
| median 129.7)。速度目標 (203s → 150s) は未達のため取り下げた — 203s は refute 期 24 run の | ||
| baseline であり、全期間 baseline (checklist era 70 run: avg 162.6s / median 129.7s) と | ||
| 比較軸が baseline の取り方に依存して不成立。diff サイズの交絡も未解消。受け入れ基準は | ||
| §採否判定基準に記載のとおり「finding 品質 (checklist ノイズ 0)」に再解釈した。 | ||
|
|
||
| ### finding 品質: 設計目標達成 | ||
|
|
||
| anomaly era REJECT 25/207 run (12.1%)、うち 13 件サンプルで checklist 型 REJECT | ||
| (DRY/TODO 単独) は **0 件** — 設計目標達成。 |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
テレメトリの母集団と分母を統一してください。
Line 270 は push-runs telemetry 212 record と記載しています。Line 274 は anomaly era 214 run と記載し、Line 282 は 25/207 run と記載しています。25/207 = 12.1% 自体は整合しますが、212、214、207 の関係と除外条件が定義されていません。
この節は採用判定の根拠です。母集団、フィルター、除外条件を明記するか、1 つの canonical corpus から全ての数値を再計算してください。docs/push-pipeline-fix-plan2.md の Lines 52-54 も 2026-08-11 時点で 212 record と記録しています。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/adr/adr-056-review-policy-anomaly-shadow.md` around lines 268 - 283,
「確定判定」節の telemetry 母集団を canonical corpus として統一し、212 record・214 run・207 run
の関係を整理してください。対象期間、フィルター、除外条件を明記したうえで、速度統計と REJECT
分子・分母を同じ母集団から再計算し、docs/push-pipeline-fix-plan2.md の 212 record 記載とも整合させてください。
| ## ステータス | ||
|
|
||
| 試験運用 (2026-07-18) / **dogfood 中 (判定期限 2026-08-15)** | ||
| **採用 (2026-08-12)** |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
採用判定後の試験運用記述を更新してください。
Line 5 と Lines 100-112 は 2026-08-12 の採用および templates の default-ON 昇格を記録します。一方、Line 44 の見出しは 決定 (試験運用) のままで、Lines 94-98 は 2026-08-15 の将来判定と default-ON 昇格前提を記載します。
採用済みの状態と試験中の状態が同じ ADR 内で混在しています。決定見出しと bounded-lifetime 節を「採用判定済み」に更新し、試験中の条件は履歴として残してください。
Also applies to: 90-112
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/adr/adr-057-docs-only-deterministic-routing.md` at line 5,
ADR内の採用済み状態と試験中状態の混在を解消してください。`決定 (試験運用)` の見出しと bounded-lifetime 節を、2026-08-12
の採用判定および templates の default-ON 昇格を反映した「採用判定済み」の内容へ更新してください。2026-08-15
の将来判定や試験中の条件は削除せず、履歴として残してください。
| **本表は 2026-07-18 時点の観測スナップショット** (R4 判定の現在地: **ADR-047 は 2026-07-19 に | ||
| 却下確定・refute workflow 撤去済み**。ADR-056 の判定は同 ADR のステータス行を参照 — 経緯は | ||
| [push-pipeline-fix-plan2.md](push-pipeline-fix-plan2.md) R4)。 | ||
| 本 doc を publish する push 自身が run 集合に混入して観測対象を変えて |
There was a problem hiding this comment.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
判定済みの ADR に合わせて Line 26 の期限注記も更新してください。
変更した Line 15-18 は ADR-047 の 2026-07-19 却下確定と ADR-056 の現行ステータスを記録します。一方、Line 26 は現在も「ADR-047/056 の判定が確定するまでは」と記載します。2026-08-12 時点では、この条件は成立しません。--until の説明を現在の判定済み状態に更新してください。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/takt-step-timings.md` around lines 15 - 18, Update the --until
explanation around the ADR-047/056 deadline note on Line 26 to reflect that both
ADR decisions are already finalized as of 2026-08-12; remove the outdated “until
the decisions are finalized” condition while preserving the existing --until
usage guidance.
| > **運用ルール**: 各タスクには **やろうとしたこと / 現在地 / 詰まっている箇所** を必ず書く。完了タスクは ADR か仕組みに反映後、このファイルから削除する。過去の経緯は git log で追跡可能。 | ||
| > | ||
| > **本ファイル + [docs/todo2.md](todo2.md) 〜 [docs/todo22.md](todo22.md) + [docs/todo-summary.md](todo-summary.md) + [docs/todo-summary2.md](todo-summary2.md) の使い分け** (PR #83 T3-2 で恒久化、2026-04-28 強化、PR #88 で todo3.md 追加、PR #96 セッションで todo4.md 追加、PR #101 セッションで todo5.md 追加、PR #123 セッションで todo6.md 追加、2026-05-09 に todo-summary.md 切り出し + todo5.md 分割で todo7.md 追加、PR #143 = 2026-05-11 で todo8.md 追加、PR #172 仕組み化方針切替 = 2026-05-25 で todo9.md 追加、PR #185 land 後 2026-05-29 で todo10.md 追加、2026-06-06 todo9.md 分割で todo11.md 追加、2026-06-12 PR #204 で todo10.md 分割により todo12.md 追加、2026-06-29 PR #224 セッションで todo13.md 追加、2026-07-19 週次レビュー WR-2026-07-19-T02 採用で todo14.md 追加、2026-07-20 docs 50KB 超過解消で todo13.md を todo15/16/17・todo10.md を todo18/19 へ物理分割、2026-08-04 todo14.md の 50KB 超過で todo20.md 追加、2026-08-08 todo20.md の 50KB 超過で todo21.md 追加、2026-08-11 todo21.md の 50KB 超過で todo22.md 追加): | ||
| > **本ファイル + [docs/todo3.md](todo3.md) 〜 [docs/todo22.md](todo22.md) + [docs/todo-summary.md](todo-summary.md) + [docs/todo-summary2.md](todo-summary2.md) の使い分け** (todo2.md は 2026-08-12 退役) (PR #83 T3-2 で恒久化、2026-04-28 強化、PR #88 で todo3.md 追加、PR #96 セッションで todo4.md 追加、PR #101 セッションで todo5.md 追加、PR #123 セッションで todo6.md 追加、2026-05-09 に todo-summary.md 切り出し + todo5.md 分割で todo7.md 追加、PR #143 = 2026-05-11 で todo8.md 追加、PR #172 仕組み化方針切替 = 2026-05-25 で todo9.md 追加、PR #185 land 後 2026-05-29 で todo10.md 追加、2026-06-06 todo9.md 分割で todo11.md 追加、2026-06-12 PR #204 で todo10.md 分割により todo12.md 追加、2026-06-29 PR #224 セッションで todo13.md 追加、2026-07-19 週次レビュー WR-2026-07-19-T02 採用で todo14.md 追加、2026-07-20 docs 50KB 超過解消で todo13.md を todo15/16/17・todo10.md を todo18/19 へ物理分割、2026-08-04 todo14.md の 50KB 超過で todo20.md 追加、2026-08-08 todo20.md の 50KB 超過で todo21.md 追加、2026-08-11 todo21.md の 50KB 超過で todo22.md 追加): |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟠 Major | ⚡ Quick win
退役と分割後の TODO ファイル一覧を全 preamble で統一してください。
docs/todo.md#L5-L5: 確認範囲をtodo2-22.mdからtodo3-22.mdに変更してください。docs/todo10.md#L5-L5: 新規詳細エントリの追加先をdocs/todo21.mdからdocs/todo22.mdに変更し、docs/todo2.mdを現存ファイル範囲から除外してください。docs/todo11.md#L5-L5: 確認範囲をtodo2-22.mdからtodo3-22.mdに変更してください。
Based on learnings: TODO preamble では、数詞だけでなく列挙範囲と実際の TODO ファイル数を一致させます。
📍 Affects 3 files
docs/todo.md#L5-L5(this comment)docs/todo10.md#L5-L5docs/todo11.md#L5-L5
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/todo.md` at line 5, 統一された TODO preamble に更新してください。docs/todo.md の 5-5 行目と
docs/todo11.md の 5-5 行目は確認範囲を todo3.md〜todo22.md に変更し、docs/todo10.md の 5-5
行目は新規詳細エントリの追加先を docs/todo22.md に変更したうえで、現存ファイル範囲から todo2.md を除外してください。
Source: Learnings
| > **運用ルール** ([docs/todo.md](todo.md) と同一): 各タスクには **やろうとしたこと / 現在地 / 詰まっている箇所** を必ず書く。完了タスクは ADR か仕組みに反映後、このファイルから削除する。過去の経緯は git log で追跡可能。 | ||
| > | ||
| > **本ファイルの位置付け**: docs/todo9.md がファイルサイズ 75KB 超 (890 行) に到達したため、Claude Code の読み取り安定性 (50KB 超で不安定化) を考慮して、PR-specific follow-up entries (PR #174 以降の post-merge-feedback 採用 entry) を本ファイルに分離 (2026-06-06)。todo9.md には「既存ルール仕組み化バンドル + 週次レビュー拡張」themed entries が残る。todo.md / todo2.md 〜 todo10.md の既存エントリは引き続き有効、相互に独立。新セッションでは24つすべてを確認すること (todo.md / todo2-22.md / todo-summary.md / todo-summary2.md)。 | ||
| > **本ファイルの位置付け**: docs/todo9.md がファイルサイズ 75KB 超 (890 行) に到達したため、Claude Code の読み取り安定性 (50KB 超で不安定化) を考慮して、PR-specific follow-up entries (PR #174 以降の post-merge-feedback 採用 entry) を本ファイルに分離 (2026-06-06)。todo9.md には「既存ルール仕組み化バンドル + 週次レビュー拡張」themed entries が残る。todo.md / todo2.md 〜 todo10.md の既存エントリは引き続き有効、相互に独立。新セッションでは23つすべてを確認すること (todo.md / todo2-22.md / todo-summary.md / todo-summary2.md)。 |
There was a problem hiding this comment.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
確認対象の範囲から退役済みの todo2.md を除いてください。
Line 5 は 23 ファイルを確認すると記載しながら、範囲を todo2-22.md としています。todo2.md は 2026-08-12 に退役済みです。現行の範囲は docs/todo3.md〜docs/todo22.md です。
Based on learnings: TODO preamble では、数詞だけでなく列挙範囲と実際の TODO ファイル数を一致させます。
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/todo11.md` at line 5, docs/todo11.md の冒頭説明文で、確認対象から退役済みの todo2.md
を除外し、列挙範囲を docs/todo3.md〜docs/todo22.md
に更新してください。実際の対象ファイル数と一致するよう、記載する総数も現行範囲に合わせて修正してください。
Source: Learnings
| > **運用ルール** ([docs/todo.md](todo.md) と同一): 各タスクには **やろうとしたこと / 現在地 / 詰まっている箇所** を必ず書く。完了タスクは ADR か仕組みに反映後、このファイルから削除する。過去の経緯は git log で追跡可能。 | ||
| > | ||
| > **本ファイルの位置付け**: docs/todo2.md がファイルサイズ約 50KB に到達したため、Claude Code の読み取り安定性 (50KB 超で不安定化) を考慮して PR #88 以降の新規エントリは本ファイルに記録した。本ファイルも PR #96 セッションで 50KB 接近のため、それ以降の新規エントリは [docs/todo4.md](todo4.md) へ。todo.md / todo2-22.md の既存エントリは引き続き有効、相互に独立。新セッションでは24つすべてを確認すること (todo.md / todo2-22.md / todo-summary.md / todo-summary2.md)。 | ||
| > **本ファイルの位置付け**: docs/todo2.md がファイルサイズ約 50KB に到達したため、Claude Code の読み取り安定性 (50KB 超で不安定化) を考慮して PR #88 以降の新規エントリは本ファイルに記録した。本ファイルも PR #96 セッションで 50KB 接近のため、それ以降の新規エントリは [docs/todo4.md](todo4.md) へ。todo.md / todo2-22.md の既存エントリは引き続き有効、相互に独立。新セッションでは23つすべてを確認すること (todo.md / todo2-22.md / todo-summary.md / todo-summary2.md)。 |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win
退役した todo2.md を TODO preamble の範囲から除外してください。
両ファイルとも、23 ファイルという件数に対して todo2-22.md を列挙しています。この範囲は退役済みの todo2.md を含むため、件数と実ファイル範囲が一致しません。
docs/todo3.md#L5-L5:todo2-22.mdをtodo3-22.mdに変更し、23 ファイルの列挙範囲と一致させてください。docs/todo4.md#L5-L5:todo2-22.mdをtodo3-22.mdに変更し、23 ファイルの列挙範囲と一致させてください。
Based on learnings: TODO preamble では、数詞だけでなく列挙範囲と実際の TODO ファイル数の一致も確認します。
📍 Affects 2 files
docs/todo3.md#L5-L5(this comment)docs/todo4.md#L5-L5
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/todo3.md` at line 5, 退役済みのtodo2.mdをTODO
preambleの列挙範囲から除外し、docs/todo3.mdの5行目とdocs/todo4.mdの5行目にあるtodo2-22.mdをtodo3-22.mdへ変更してください。23ファイルという件数と実際の列挙範囲が一致する状態を両ファイルで維持してください。
Source: Learnings
| > **運用ルール** ([docs/todo.md](todo.md) と同一): 各タスクには **やろうとしたこと / 現在地 / 詰まっている箇所** を必ず書く。完了タスクは ADR か仕組みに反映後、このファイルから削除する。過去の経緯は git log で追跡可能。 | ||
| > | ||
| > **本ファイルの位置付け**: docs/todo6.md がファイルサイズ 50KB に到達したため、Claude Code の読み取り安定性 (50KB 超で不安定化) を考慮して PR #143 T3-#1 採用時 = 2026-05-11 から新規エントリは本ファイルに記録していた。**本ファイルも 60KB に到達したため、PR #172 仕組み化方針切替セッション = 2026-05-25 以降の新規エントリは [docs/todo9.md](todo9.md) へ移行**。本ファイルは既存タスクの編集・完了削除専用。**新規エントリの現在の追加先は [docs/todo21.md](todo21.md)** (todo9 → todo10 → todo13 → todo14 → todo20 → todo21 と移動してきた)。todo.md / todo2.md 〜 todo7.md / todo9.md 〜 todo21.md の既存エントリは引き続き有効、相互に独立。新セッションでは24つすべてを確認すること (todo.md / todo2-22.md / todo-summary.md / todo-summary2.md)。 | ||
| > **本ファイルの位置付け**: docs/todo6.md がファイルサイズ 50KB に到達したため、Claude Code の読み取り安定性 (50KB 超で不安定化) を考慮して PR #143 T3-#1 採用時 = 2026-05-11 から新規エントリは本ファイルに記録していた。**本ファイルも 60KB に到達したため、PR #172 仕組み化方針切替セッション = 2026-05-25 以降の新規エントリは [docs/todo9.md](todo9.md) へ移行**。本ファイルは既存タスクの編集・完了削除専用。**新規エントリの現在の追加先は [docs/todo21.md](todo21.md)** (todo9 → todo10 → todo13 → todo14 → todo20 → todo21 と移動してきた)。todo.md / todo2.md 〜 todo7.md / todo9.md 〜 todo21.md の既存エントリは引き続き有効、相互に独立。新セッションでは23つすべてを確認すること (todo.md / todo2-22.md / todo-summary.md / todo-summary2.md)。 |
There was a problem hiding this comment.
🗄️ Data Integrity & Integration | 🟡 Minor | ⚡ Quick win
TODO preamble の ledger と routing を全ファイルで一致させてください。
todo2.md は 2026-08-12 に退役しました。そのため、todo.md、todo2.md〜todo22.md、2つの summary は24パスですが、「23件」と一致しません。docs/todo8.md は現在の追加先も docs/todo21.md としており、docs/todo22.md の Line 1-5 と矛盾します。
docs/todo8.md#L5-L5: 追加先をdocs/todo22.mdに変更し、確認対象をtodo.md、todo3.md〜todo22.md、2つの summary に修正する。docs/todo5.md#L5-L5:todo2.mdを範囲から除外し、退役を明記する。docs/todo6.md#L5-L5:todo2.mdを範囲から除外し、23件の一覧に修正する。docs/todo7.md#L5-L5:todo2.mdを範囲から除外し、23件の一覧に修正する。docs/todo9.md#L5-L5:todo2.mdを範囲から除外し、23件の一覧に修正する。
共通の修正例
- todo.md / todo2-22.md / todo-summary.md / todo-summary2.md(23件)
+ todo.md / todo3-22.md / todo-summary.md / todo-summary2.md(23件、todo2.md は 2026-08-12 退役)
- 新規エントリの現在の追加先は docs/todo21.md
+ 新規エントリの現在の追加先は docs/todo22.mdBased on learnings(取得した学習): TODO preamble は数詞だけでなく、列挙範囲に最新の TODO ファイルが含まれるかも確認する必要があります。提示された PR 目的と docs/todo22.md に基づきます。
📍 Affects 5 files
docs/todo8.md#L5-L5(this comment)docs/todo5.md#L5-L5docs/todo6.md#L5-L5docs/todo7.md#L5-L5docs/todo9.md#L5-L5
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@docs/todo8.md` at line 5, 更新されたTODOファイルの台帳と追加先を全サイトで一致させる。docs/todo8.md の
preamble は追加先を docs/todo22.md に変更し、確認対象を todo.md、todo3.md〜todo22.md、2つの
summary(23件)に修正する。docs/todo5.md、docs/todo6.md、docs/todo7.md、docs/todo9.md の各
preamble では todo2.md を対象範囲から除外し、退役済みであることを明記したうえで23件の一覧に更新する。
Source: Learnings
🤖 PR Monitor 分析 (GitHub Actions バックストップ)
Applicable Findings (Critical / High / Major)
Applicable Findings (Medium 以下)
Filtered (not applicable)
次のアクション
|
…r 7 日差し戻し 棚卸し (35 ファイル全件調査) の採否確定分を一括反映する。 判定確定 (bounded lifetime): - ADR-056 採用 (速度目標取り下げ、二重 miss 10 件/6 PR の実測を記録し却下条件を精緻化) - ADR-057 採用 (51 docs-only run / 誤 skip 0 / -54.2s/run。templates へ default-ON 反映) - ADR-058 採用 (changed_block 1 件は flaky 誤 block と確定、真の検出 0 件を正直に記録) - ADR-059 採用 (CLI=描画 / VSCode=非描画で defense-in-depth が代替。第 2 弾展開は見送り) - auto-push gate B1-loop NO-GO (観測手段欠落 + 経路消滅。ADR-043 amendment へ転記) - 順位 247 継続 (延長 1 回目)、順位 319 dogfood 不合格 (29 PR 実測 69% 重複) を記帳 計画書の退役: - file-length-enforcement-plan.md 削除 (全 6 PR 完了、分割制約は dev-conventions へ移設) - weekly-review-notification-plan.md 削除 (削除条件決着を ADR-059 § 確定判定へ転記) - todo2.md 退役 (ADR-032 ブロックは ADR-057 実現で廃止、残 2 タスクを todo22 へ移送) - auto-push-gate-dogfood.md 削除 (NO-GO 判定、ADR-043 amendment へ転記) 台帳整理: - ADR-030 Phase E (旧機構廃止) を撤回し順位 27 決着 (ADR-030 § 撤回記録) - 順位 51/225/11/20/21/22/333 を削除、todo14 孤児 4 件を採番 (433-436) - 新規起票 7 件 (437-443: rules 採否 / branch 回収 / gate telemetry / weekly-review 保存 / docs-lint 1:1 検査 / security facet 敵対的観点 / flaky 当たり面) - グローバル文書対象 17 エントリに旧環境実査の Status update 注記 - push-pipeline-fix-plan/plan2 の stale 記載を #292/#293/#294 マージ済みに更新 運用変更: - weekly reminder_threshold_days 30→7 差し戻し (ADR-070 の 30 日は routine 正常稼働が 前提だが成果物デリバリ未確立のため。再引き上げは保存問題解消後に再評価) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
5ea38a3 to
e6a04c1
Compare
概要
docs/ 直下の一時作業ドキュメント 35 ファイルの全件棚卸し (2026-08-12) で確定した採否を一括反映する。
期限判定の確定 (bounded lifetime)
計画書の退役 (3 本削除 + 1 ファイル退役)
台帳整理
運用変更
検証
pnpm lint:docs(cli-docs-lint preamble/cross-ref/priority-inversion) OK / markdownlint 104 ファイル 0 error🤖 Generated with Claude Code
Summary by CodeRabbit