docs(llm-offload): PR #152 (D-6) post-merge follow-up + analysis.md 軽量化 (49KB→26KB)

[aloekun]

Summary

PR #152 (D-6) merge 後のドキュメント整理を 2 commit にまとめた PR:

1. docs(todo): Bundle k 既存 entry に PR feat(takt-facet): D-6 — refresh review-diff between fix/review iterations + Bundle k post-merge-feedback #152 post-merge-feedback の再観測を追記 (順位 123/124/126/127)
2. docs(llm-offload): analysis.md に D-6 完了状況を反映 + Phase A〜D の完了済み詳細を新ファイル phase-d-outcomes.md に分離 (50KB 接近回避)

Commit 1: Bundle k 既存 entry 更新

PR #152 post-merge-feedback で 採用 4 件が すべて Bundle k (順位 123/124/126/127) の既存エントリと完全重複 していたため、新規順位を追加せず 既存 entry に PR #152 を追加観測として追記 した:

• 順位 123 (lint-screen MD 除外): 3 PR → 4 PR 観測 に更新
• 順位 124 (TOML positive test): 2 PR 連続 test gap を再確認
• 順位 126 (ADR-038 hallucinate codify): 3 PR → 4 PR 観測 に更新
• 順位 127 (extensions point-of-edit comment): 2 PR 連続で再採用された旨を追記
• todo-summary.md に「Bundle k 補強 (PR feat(takt-facet): D-6 — refresh review-diff between fix/review iterations + Bundle k post-merge-feedback #152 post-merge-feedback)」段落を新設

post-merge-feedback workflow が duplicate detection の能力を持つ一方で Recommendation 列で「✅ 採用」を出すパターンを発見。今後の post-merge-feedback handling では analyzer 出力を一次評価で重複判定する運用とする (workflow 設計の potential improvement)。

Commit 2: analysis.md 軽量化 + phase-d-outcomes.md 新設

動機: docs/local-llm-offload-analysis.md が 49,374 B (50KB 接近) に到達し、Claude Code 読み取り安定性に影響するリスクが顕在化。todo.md 系列の 50KB 分割 (PR #133) と同じパターン。

整理方針 (advisor レビュー済み):

• Phase A〜D 完了済み詳細 (~21KB) を新ファイル docs/local-llm-offload-phase-d-outcomes.md に分離
  • Phase A: Diagnostic / Phase B: Root cause id / Phase C: Root cause fix
  • Phase D 前提整備 (順位 109) / Phase D Round 1 D-1/D-2/D-3 outcome / Phase D Round 2 D-4/D-5/D-6 outcome
  • Phase E 判定材料 / Dogfood signal log (旧 PR roster feat(adr+rules): Bundle h+g-2 — ADR-039 + global rules 4 件 codify (P-1 dogfood with caveat) #139/feat(lint): rule⑧ no-docs-relative-back-to-docs (Phase d P-2 / Bundle j-1 / 順位 94) #140/test(custom-lint): rule⑥ self-exclusion 回帰テスト + Bundle g-1 stale cleanup (Phase d P-3 繰上げ) #141)
• analysis.md に残置: D-7 plan / Phase D 計測手順 (D-7 runbook) / Phase E retirement plan / Critical path 外 / 関連リンク
• D-6 完了状況: D-6 行を「✅ PR feat(takt-facet): D-6 — refresh review-diff between fix/review iterations + Bundle k post-merge-feedback #152 merged」に更新、observation tally を D-3+D-4+D-5+D-6 = 6 data points (4 PR) に更新、Phase E 着手前提条件 (3-5 PR) は D-6 完遂時点で既に充足 と明示
• 引退条件 (docs-governance.md retirement workflow 準拠): analysis.md / history.md / phase-d-outcomes.md の 3 ファイル同時削除 に更新。新ファイル側にも同じ retirement clause を明記し ephemeral lifecycle を整合

ファイルサイズ変化:

ファイル	Before	After	Delta
local-llm-offload-analysis.md	49,374 B	25,910 B	-47.5%
local-llm-offload-phase-d-outcomes.md	(新規)	21,765 B	+21,765 B

advisor 助言 (3 ファイル lifecycle 整合 / 計測手順は残す / §1 サマリー残置で §8.E line 153 cross-ref 維持) に沿って実装。

Pre-push review observation

• takt review: 1 iter で APPROVE (2m 54s)
• simplicity / security: 共に APPROVE、blocking anomaly なし
• pipeline 総時間: 502s

Test plan

• pnpm lint 0 errors
• markdownlint via PostToolUse hook: 0 errors
• takt pre-push-review pipeline 完走 (APPROVE)
• wc -c で analysis.md が 26KB に縮小したことを確認
• 新ファイル phase-d-outcomes.md の cross-ref (analysis.md / history.md / phase-d-guide.md) が解決
• 引退条件の 3 ファイル整合 (analysis.md ヘッダー + phase-d-outcomes.md ヘッダー)

Files

Commit 1 (uztmkzmu):

• docs/todo-summary.md (順位 123/124/126/127 inline 更新 + Bundle k 補強段落新設)
• docs/todo8.md (4 既存 entry の PR feat(takt-facet): D-6 — refresh review-diff between fix/review iterations + Bundle k post-merge-feedback #152 再観測追記)

Commit 2 (ursxwvpu):

• docs/local-llm-offload-analysis.md (Phase A〜D 詳細削除 + 経過サマリー table 新設 + 引退条件更新 + 関連リンク追加)
• docs/local-llm-offload-phase-d-outcomes.md (新規ファイル、Phase A〜D 完了済み詳細を集約)

Summary by CodeRabbit

リリースノート

• Documentation
  • 内部プロジェクト計画ドキュメントを更新し、フェーズ完了状況と詳細な観測結果を整理しました。
  • 新しいドキュメントを追加し、実行段階での結果データを記録しました。
  • タスク追跡情報を最新の観測内容に基づいて更新しました。

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7af28482-dc3d-4cc8-8507-d8d1228b9e42

📥 Commits

Reviewing files that changed from the base of the PR and between 06b4412 and 04fba45.

📒 Files selected for processing (4)

• docs/local-llm-offload-analysis.md
• docs/local-llm-offload-phase-d-outcomes.md
• docs/todo-summary.md
• docs/todo8.md

---

📝 Walkthrough

概要

Phase d Round 2 の進捗状況をメイン分析ドキュメントで整理し、詳細な観測・測定結果を新規専用ドキュメントに記録し、その観測を既存タスク予測に反映する文書更新。

変更内容

Phase D Round 2 から Phase E への進捗とトリアージ

レイヤー / ファイル	概要
メイン分析文書の Phase D/E 進捗フレーミング docs/local-llm-offload-analysis.md	実行計画ドキュメントの導入部で現在の試行状態（Phase d Round 1 完了・Round 2 進行中）を再フレーミングし、引退条件を 3 ファイル削除の連動に整理。Phase A-D 詳細叙述を統合テーブル（PR 番号・完了日付・スコープ）へ置き換え、D-7 の残存スコープと Phase E セクション（採否判定ケース、ADR-038 昇格/リバート/継続アクション）を新たに追加。関連リンクを Phase D 成果ドキュメントへ指向。
Phase D 詳細観測ログと Phase E 判定材料ドキュメント docs/local-llm-offload-phase-d-outcomes.md	新規ドキュメントを作成。Phase A-C の完了済み詳細（診断メタデータ・根本原因の num_ctx truncation・修正の DEFAULT_NUM_CTX 段階引き上げ・観測結果）と Phase D Round 1/2 の実観測データ（LINT_SCREEN_ENABLED override、lint_screen の verdict・fallback・finding 実測・D-4/D-5 の同一 PR 内 2 push event、D-6 docs-only auto_fix）、Phase E 採択判定用の集計指標（end-to-end 成功・overflow なし・累積 fallback 率・false positive 累積・verdict variance・累積 PR data 充足）、cli-finding-classifier preview ログ（kill-switch 超過と復旧の関係）を記載。
PR #152 D-6 の観測をタスク予測に反映 docs/todo-summary.md, docs/todo8.md	Bundle k タスク（順位 123-127）の説明と Bundle k ブロック自体を更新。PR #152 D-6 での再観測（lint-screen .md unused-import false positive、観測頻度 3 PR → 4 PR 更新）を反映。docs/todo8.md の 4 つのタスク説明（lint-screen .md フィルター、no-ephemeral-todo-reference TOML positive test、ADR-038 mistral:7b context hallucinate failure mode、extensions 拡張時の test 追加パターン明文化）に PR #152 を含めた再観測・再確認文言を追記。

関連 PR

• aloekun/claude-code-hook-test#149: Phase D 完了マーク と D-3 メトリクス/テーブルを追加する以前の PR。
• aloekun/claude-code-hook-test#138: Phase d guide ドキュメントを導入し、本 PR で再フレーミングされるベースの決定を記録。
• aloekun/claude-code-hook-test#152: D-6（docs-only review-diff refresh）の観測が本 PR で todo/outcome ドキュメントに反映される。

レビュー所要時間

🎯 2 (Simple) | ⏱️ ~10 分

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PRのタイトルは、PR #152のマージ後のドキュメント整理と analysis.md の軽量化（49KB→26KB）という主要な変更を正確に反映しており、ファイル分割と観測データ更新という実質的な変更内容を簡潔かつ具体的に説明している。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}