Skip to content

docs: Bundle j 登録 + Phase c MVP land 反映 (PR #132 post-merge-feedback)#134

Merged
aloekun merged 1 commit into
masterfrom
docs-bundle-j-and-phase-c-land
May 9, 2026
Merged

docs: Bundle j 登録 + Phase c MVP land 反映 (PR #132 post-merge-feedback)#134
aloekun merged 1 commit into
masterfrom
docs-bundle-j-and-phase-c-land

Conversation

@aloekun
Copy link
Copy Markdown
Owner

@aloekun aloekun commented May 9, 2026

Summary

Background

Test Plan

  • pnpm push パイプライン (lint/test/build/rust-test) PASS
  • takt pre-push-review (security-review + simplicity-review) ともに APPROVE
  • ADR-035 docs-only judgment 適用 (人間レビュー軽め運用)
  • Markdown link 整合性確認 ((todo6.md) リンクが docs/local-llm-offload-analysis.md から正しく解決される)

Summary by CodeRabbit

  • Documentation
    • 実装進捗状況を更新(Phase b/c の達成条件と実装内容を明記)
    • 再実行手順と再開チェックリストを追記
    • ドキュメント検証用の新規タスクを追加(相対パス検査、リンク整合性確認など)

Review Change Stack

- todo6.md / todo-summary.md に Bundle j 3 タスク追加 (順位 94-96)
  - 94: docs/ 内 ../docs/ 相対パストラップ検出 lint rule (Tier 1, S)
  - 95: docs/todo*.md preamble file count 自動照合 (Tier 2, S)
  - 96: Markdown cross-reference validator CI step (Tier 2, M)
- local-llm-offload-analysis.md に Phase c MVP 完了 (PR #132) を反映
  - 実装方針変更 (takt facet -> cli-push-runner stage) を §1 Phase c に記述
  - Phase c+ (Bundle i) として PR #132 post-merge-feedback 採用 3 件
  - §8.E を MVP land 済みステータスに更新
  - 再開チェックリストに Phase c smoke / Bundle i 着手手順を追加
- todo-summary.md retrospective に Bundle j (PR #133 post-merge-feedback) 追記
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 9, 2026

📝 Walkthrough

概要

PR #134は、Phase c(lint screen機能)の試験運用ステータス更新、MVP実装詳細の記録、および後続タスク(Bundle j)の定義を含むドキュメント更新です。Phase b/cの達成条件を反映し、cli-push-runner Rust stageでの実装、フォールバック動作、設定方針、観測事象(mistral:7b JSON欠落)とBundle iフォローアップを詳細化。再開チェックリストと優先度リストを追加し、docs整合性多層検証(3タスク)をBundle jとして新規定義します。

変更内容

Phase c試験運用の実装記録と再開ガイド

レイヤー / ファイル 概要
ステータス更新
docs/local-llm-offload-analysis.md
Phase b/c達成条件(conditional GO、PR番号、日付)およびPhase d未着手を状態欄に記載。
MVP実装詳細化
docs/local-llm-offload-analysis.md
Phase c(§8.E)をcli-push-runner Rust stageでのMVP実装に詳細化、出力・パイプライン・設定・フォールバック・レビュー連携を記録。mistral:7b大規模diff時JSON欠落観測とBundle iフォローアップ(config検証、fixtures、coding-style anti-pattern)を追加。
提案仕様更新
docs/local-llm-offload-analysis.md
§8.E(提案1)をPR #132 MVP land済み方針に更新、scope(報告のみ・gating無・auto-fix無・default OFF)とBundle i・Phase d着手前提を明記。
再実行ガイド
docs/local-llm-offload-analysis.md
別セッション再開チェックリスト(master最新化→Phase a/c反映→Ollama起動→Phase b再現→Phase c MVP smoke)と優先度リスト(Bundle i→coding-style→Phase d)を追加。
Bundle jタスク定義(概要表)
docs/todo-summary.md
PR #133対応Bundle j(docs整合性検証)の3タスクを推奨実行順序表に追加(順位94〜96)、タスク詳細・工数・依存関係を記載。
Bundle j仕様説明
docs/todo-summary.md
Bundle j説明文(採用対策・Sub-PR分割推奨・却下/様子見根拠)を戦略セクションに追記。
Bundle jタスク詳細
docs/todo6.md
3タスク詳細(相対パストrap検出lint、preamble自動照合、cross-reference validator)を設計案・作業計画・完了基準付きで追加。

関連PR

🎯 2 (Simple) | ⏱️ ~12 分

🚥 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 The title clearly and specifically describes the main changes: adding Bundle j tasks and reflecting Phase c MVP completion with PR #132 post-merge feedback. It is concise and directly related to the documentation updates.
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

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

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/todo-summary.md (1)

8-8: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

更新日が最新変更と一致していません。

Line 8 の見出しが「2026-04-29 更新」のままですが、今回 2026-05-09 の内容(Bundle j)を追加しています。検索性と運用精度のため、更新日を最新化してください。

✏️ 修正案
-## 推奨実行順序サマリー (2026-04-29 更新、ADR-033 採番管理簡素化 land 後)
+## 推奨実行順序サマリー (2026-05-09 更新、ADR-033 採番管理簡素化 land 後)
🤖 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-summary.md` at line 8, 見出し "## 推奨実行順序サマリー (2026-04-29 更新、ADR-033
採番管理簡素化 land 後)" の更新日が古いので、今回追加した内容(Bundle j)を反映するために見出し内の日付を "2026-05-09"
に更新し、必要ならカッコ内の補足(例: "Bundle j 追加")を追記して検索性と運用精度を保ってください。
🧹 Nitpick comments (1)
docs/local-llm-offload-analysis.md (1)

149-149: ⚡ Quick win

テスト件数の固定値は将来すぐ陳腐化しやすいです。

Line 149 の「47+ 件 pass」は保守コストが高いので、件数を外して「全件 pass」などの表現に寄せると運用が安定します。

🛠️ 文言の簡易修正案
-cargo test -p cli-push-runner                                    # 47+ 件 pass
+cargo test -p cli-push-runner                                    # テストが全件 pass することを確認
🤖 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/local-llm-offload-analysis.md` at line 149,
行末の固定テスト件数表記を削除して将来の陳腐化を防いでください: "cargo test -p cli-push-runner"
の出力説明で現在使っている「47+ 件 pass」を「全件 pass」や「All tests
passed」のような汎用的な表現に置き換え、同じ行(該当テキスト)で数値に依存しない文言に修正してください。
🤖 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.

Outside diff comments:
In `@docs/todo-summary.md`:
- Line 8: 見出し "## 推奨実行順序サマリー (2026-04-29 更新、ADR-033 採番管理簡素化 land 後)"
の更新日が古いので、今回追加した内容(Bundle j)を反映するために見出し内の日付を "2026-05-09" に更新し、必要ならカッコ内の補足(例:
"Bundle j 追加")を追記して検索性と運用精度を保ってください。

---

Nitpick comments:
In `@docs/local-llm-offload-analysis.md`:
- Line 149: 行末の固定テスト件数表記を削除して将来の陳腐化を防いでください: "cargo test -p cli-push-runner"
の出力説明で現在使っている「47+ 件 pass」を「全件 pass」や「All tests
passed」のような汎用的な表現に置き換え、同じ行(該当テキスト)で数値に依存しない文言に修正してください。

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 915abf1a-b11c-4e9d-bee3-d0fc673e8d10

📥 Commits

Reviewing files that changed from the base of the PR and between 4210e79 and 7d29cca.

📒 Files selected for processing (3)
  • docs/local-llm-offload-analysis.md
  • docs/todo-summary.md
  • docs/todo6.md

@aloekun aloekun merged commit ccca017 into master May 9, 2026
1 check passed
@aloekun aloekun deleted the docs-bundle-j-and-phase-c-land branch May 9, 2026 10:04
aloekun added a commit that referenced this pull request May 29, 2026
…ndle CR-RL 採用 3 件 (#183)

* docs(todo): PR #182 post-merge-feedback Bundle CR-RL 採用 3 件 + 順位 165 補足追記

採用: PR #182 post-merge-feedback (2026-05-29 ユーザー承認):
- 順位 167 (T1-#1): check-ci-coderabbit の RATE_LIMIT_MARKER を新フォーマット対応に更新
- 順位 168 (T2-#1): CR rate-limit detection integration test の新旧 fixture
- 順位 169 (T3-#1): ADR-018 / ADR-034 に CR rate-limit format evolution 同期戦略 codify

3 件は Bundle CR-RL タグで同 PR land 推奨 (機械強制 + test 層 + 永続 ADR 層の 3 層補強)。

順位 165 補足追記:
- PR #182 T2-#2 採用候補 (pnpm-create-pr-body-guard hook test) は本 165 と scope 重複のため独立 entry 化せず本 entry に集約
- supplementary fact: PR #134 で pnpm-create-pr-body-guard hook 採用判定されたが未実装の state (= stale unfulfilled adoption、feedback-reports/134.md Tier 1 #1)
- 165 着手時に hook 実装済なら test 範囲を 2 層 (--body-file workaround verify + guard hook 動作 verify) に拡張

* docs(adr): 8 ADR の ephemeral todo 参照を permanent reference に置換 (A01 fix、Cross-File Reference Lifecycle 違反修正)

PR #182 Phase B dogfood で検出された finding WR-2026-05-29-A01 (Severity High、Category adr-alignment) の修正。
8 永続 ADR が docs/todo*.md の section / 順位 N / Phase A-F 等の ephemeral artifact を直接参照しており、
docs-governance.md § Retirement Workflow で todo entry が削除された際に silent dead pointer 化する
systemic documentation drift の構造修正。

修正方針 (analyzer 推奨 3 strategy):
1. ADR cross-references — 別 ADR に decision がある場合
2. PR # references — git log で origin が trackable な場合
3. Inlined constraints — detail が小さい場合

各 ADR の修正:
- ADR-022 line 197: parenthetical pointer 削除 (operational guideline は self-contained で完結)
- ADR-023 lines 54, 86: "docs/todo.md or PR description" → "PR description" (permanent artifact のみに集約)
- ADR-028 line 186: "docs/todo.md #7" → "PR #59 で land、PR #62 で global skill 移管"
- ADR-029 lines 191, 240, 266: task pointer 削除 + ADR-030 supersede note
  (本 ADR は ADR-030 partial supersede 対象、実装系譜は ADR-030 に集約)
- ADR-030 line 417: Phase B-F section pointer → 各 Phase の land 済 PR # (PR #75/77/80/154) を直接列挙、
  Phase E/F は priority table 参照 (specific 順位 番号は避ける)
- ADR-031 line 270: Phase A-F section pointer → PR #182 + priority table (順位 8 は trackable level の言及)
- ADR-033 line 111: grep procedure hardcoded list (todo.md/2/3) → glob (todo*.md)
  本 ADR land 時から todo4-9 が追加されており hardcode list は既に stale
- ADR-034: "todo-summary.md / todo4.md エントリ" section + "新セッションで最初に確認すべきこと"
  を全面再構成、4 component の land 状況を PR # primary table 化 (旧 順位 42 = PR #113 等)、
  新セッション checklist を ADR-018 + memory + grep ベースに置換

修正外 (operational reference として保持):
- ADR-031 lines 79, 84, 96, 121, 185, 189-191, 205, 207, 240, 242, 251, 302: workflow が
  todo.md に書き込む / セクション作成する behavior 記述 (pointer ではない operational description)
- ADR-033 lines 1, 11, 24, 93, 100, 130, 131: ADR 本体が todo.md 管理がテーマのため intrinsic
- ADR-034 lines 195-198 (Bundle b との関係 table): 順位 N と PR # / Bb-N が pair で書かれているため
  permanent reference (PR #) が常にあり、dead pointer リスクなし
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant