Skip to content

docs: 月次レビュー dogfood 追加アクション (A-D) 実装プラン + フィードバック採用 todo 登録 - #334

Merged
aloekun merged 2 commits into
masterfrom
docs/monthly-roi-followup-plan
Jul 30, 2026
Merged

docs: 月次レビュー dogfood 追加アクション (A-D) 実装プラン + フィードバック採用 todo 登録#334
aloekun merged 2 commits into
masterfrom
docs/monthly-roi-followup-plan

Conversation

@aloekun

@aloekun aloekun commented Jul 30, 2026

Copy link
Copy Markdown
Owner

概要

月次ハーネス ROI レビュー (ADR-062) の
初回 dogfood (/monthly-review, 2026-07-30) で発見した構造的問題への追加アクション A〜D を
実装指示書として起こし、あわせて #329#333 series の post-merge feedback 採用分を todo 登録する。
docs-only。

実装指示書 (新規)

docs/monthly-harness-roi-review-plan.md — 前身 (WP-12 step 2/3 の Phase 0〜4) は PR #333 で ADR 反映を
照合のうえ削除済み。同パスに後継 doc として、dogfood 起点の追加アクション A〜D を file:line と
grep 用文言つきで自己完結
に記述 (実装は別セッションで本 doc のみを見て実施できる形)。

# 深刻度 問題 対処 (設計決定)
A Critical 「発火 0 = 削除候補」シグナルが不動作 (機構レジストリ欠如 + zero_firing_list デッドロジック)。ADR-062 § 決定 4 の「発火 0 リスト全般で足りる」が実装で未充足 機構レジストリ導入 (rule=custom-lint-rules.toml / preset=hooks-config.toml / hook=config 静的リスト) + 発火 0 の 2 区分 (never-fired / went-quiet)
B High PR #333 の degraded 保守化 (extra_roots では解除しない仕様) の文書波及漏れ 5 箇所 SKILL.md 3 箇所 + ADR-062 § 決定 5 + memory の同期、「main からは恒久 degraded」の運用帰結を明記
C Medium rollup 確定時の snapshot が「月中の状態」でなく「確定時点 (翌月)」で上書きされ、無効化月を enabled と誤認して promote streak に算入し得る resolve_month で過去月確定時に prev.snapshot を保持
D Medium 未確定の当月が promote streak に算入され「連続 2 か月発火 0」の実効閾値が弱まる promote 判定を確定月のみに限定

フィードバック採用 todo 登録

#329#333 series の post-merge feedback で採用した A1〜A4 + D1 を docs/todo14.md (詳細エントリ) +
docs/todo-summary2.md (順位 352〜356) に登録:

  • 352: plan doc → ADR 転記照合チェックリスト (dev-conventions.md)
  • 353: ADR amendment 時「§ Amendment」節追加チェックリスト
  • 354: todo ファイル削除・更新チェックリスト
  • 355: 新規スキル作成チェックリスト (3 点セット等)
  • 356: weekly/monthly staleness 共通 fixture parametrized test

検証

  • docs-only。pnpm lint:md 全通、pnpm lint:docs (cli-docs-lint: preamble + cross-ref +
    priority-inversion) OK。
  • quality gate: docs-only routing で rust-lint-test skip、lint/test/build PASS。
  • takt pre-push-review APPROVE (security / simplicity)。

🤖 Generated with Claude Code

Summary by CodeRabbit

  • ドキュメント
    • 月次ハーネス ROI レビューの実装・検証計画を追加しました。
    • ADR との照合、運用手順、同期・デプロイ確認、完了後の整理フローを明文化しました。
    • 関連する開発チェックリストと、TODO 管理・テスト強化に関する項目を追加しました。
    • フェーズ完了時の記録整合性や、週次・月次判定の一貫性を確認しやすくしました。

月次 ROI レビュー (ADR-062) の初回 dogfood (/monthly-review, 2026-07-30) で発見した構造的問題への
追加アクション A-D を docs/monthly-harness-roi-review-plan.md (前身は PR #333 で削除、同パスの後継
doc) として起こす:

- A [Critical]: 発火 0 = 削除候補シグナルの不動作 (機構レジストリ欠如 + zero_firing_list デッドロジック)
- B [High]: degraded 保守化 (PR #333) の文書波及漏れ 5 箇所の同期
- C [Medium]: rollup 確定時 snapshot が月中状態でなく確定時点で上書きされる問題
- D [Medium]: 未確定当月が promote streak に算入される問題

file:line と grep 用文言つきで自己完結記述。あわせて #329-#333 series の post-merge feedback
採用分 (A1-A4 + D1) を todo14.md + todo-summary2.md 順位 352-356 に登録。

docs-only。pnpm lint:md / lint:docs 全通。
@coderabbitai

coderabbitai Bot commented Jul 30, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: ca2ffddb-4d9c-4df1-9b01-e6acec2cb240

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

月次ハーネス ROI レビューの実装計画、ADR-062 amendment 対応、検証要件、運用チェック項目をドキュメントへ追加した。

Changes

月次ハーネス ROI レビュー

Layer / File(s) Summary
計画と設計決定
docs/monthly-harness-roi-review-plan.md
レビューの背景・完了条件・設計決定・参照資料を追加した。
実装フェーズと検証要件
docs/monthly-harness-roi-review-plan.md
Phase A〜E の実装指示、共通検証、リスク、スコープ外項目を記述した。
運用チェック項目の追記
docs/todo-summary2.md, docs/todo14.md
ADR 転記、amendment、todo 更新、スキル作成、staleness テストに関するタスクを追加した。

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

🚥 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 月次レビューの追加アクションA-Dの実装プランと、採用済みフィードバックのTODO登録を適切に要約しています。
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.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/monthly-roi-followup-plan

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.

@github-actions

Copy link
Copy Markdown
Contributor

🤖 PR Monitor 分析 (GitHub Actions バックストップ)

  • トリガー: issue_comment (created) / 実行 run
  • CI: 専用 CI チェックなし (docs-only PR)。CodeRabbit レビューは処理中 (pending) — 待たずに現時点の情報のみで分析
  • レビュー状況: 人間レビューなし / インライン指摘なし / CodeRabbit は "Currently processing new changes" の定型通知のみ (レビュー内容未着)
  • Verdict: user_decision (レビュー指摘が皆無のため applicable/filtered 判定対象がなく、CI もクリーンな docs-only PR。マージ可否はユーザー判断待ち)

Applicable Findings (Critical / High / Major)

該当なし (レビュー指摘なし)

Applicable Findings (Medium 以下)

該当なし

Filtered (not applicable)

該当なし

次のアクション

  • 現時点でレビュー指摘・CI失敗なし。docs-only 変更 3 ファイル (docs/monthly-harness-roi-review-plan.md +266、docs/todo14.md +108、docs/todo-summary2.md +5) の内容確認はユーザー判断に委ねる
  • CodeRabbit のレビュー結果が届き次第、新規指摘の有無を次回起動時に再確認する

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 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/monthly-harness-roi-review-plan.md`:
- Around line 74-77: Update the “未文書化の運用帰結” section to replace the unconditional
“恒久的に degraded” wording with a conditional statement tied to ccht-improve’s
unresolved workspace root. Preserve the existing explanation that main-workspace
execution can recover to non-degraded once root resolution is fixed, and retain
the improve-workspace execution guidance.
- Around line 3-10: 「本ドキュメントのみで実装可能」という宣言と、ソース確認に依存する未確定の rule/preset/hook
設定が矛盾している。計画書内で対象ファイル、必要フィールド、レジストリ入力契約、期待する
ID・語彙を明記するか、冒頭の自己完結性宣言を「本書を起点にソース確認を行う」旨へ修正し、追加アクション A〜D の該当箇所にも一貫して反映する。

In `@docs/todo14.md`:
- Around line 434-438: Update the decision-count wording in the phase-completion
checklist entry for the plan-to-ADR review: correct the design-decision count
and resulting total to match the referenced plan, or remove the aggregate total.
Preserve the checklist requirement to verify every user decision, design
decision, and implementation consideration before deleting the plan document.
🪄 Autofix (Beta)

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: 8a664604-3de9-4491-909f-6e5357a5b9f6

📥 Commits

Reviewing files that changed from the base of the PR and between 6c7c805 and 0812270.

📒 Files selected for processing (3)
  • docs/monthly-harness-roi-review-plan.md
  • docs/todo-summary2.md
  • docs/todo14.md

Comment thread docs/monthly-harness-roi-review-plan.md
Comment thread docs/monthly-harness-roi-review-plan.md Outdated
Comment thread docs/todo14.md
@github-actions

Copy link
Copy Markdown
Contributor

🤖 PR Monitor 分析 (GitHub Actions バックストップ)

  • トリガー: pull_request_review (submitted) / 実行 run
  • CI: 専用 CI チェックなし (docs-only PR、変更ファイル3件すべて docs/**/*.md)。CodeRabbit チェックは pass (Review completed)。analyze チェックは本バックストップ自身の実行中エントリ
  • レビュー状況: CodeRabbit が review submitted (state: COMMENTED)、インライン指摘 3件。人間レビューなし (reviewDecision 未設定)
  • Verdict: needs_fix (Major 指摘が1件存在)

Applicable Findings (Critical / High / Major)

# File (Line) Reviewer Issue Recommended Action
1 docs/monthly-harness-roi-review-plan.md (3-10) CodeRabbit 冒頭の「本ドキュメントのみで実装可能」という自己完結性宣言と、rule/preset/hook 設定がソース確認依存で未確定なままの記述が矛盾している 対象ファイル・必要フィールド・レジストリ入力契約・期待する ID/語彙を計画書内に明記するか、冒頭の宣言を「本書を起点にソース確認を行う」旨へ修正し、追加アクション A〜D の該当箇所にも一貫して反映する

Applicable Findings (Medium 以下)

# File (Line) Reviewer Issue Recommended Action
2 docs/monthly-harness-roi-review-plan.md (74-77) CodeRabbit 「(main workspace からの実行は) 恒久的に degraded」という無条件表現が、ccht-improve の root 解決が修復されれば非 degraded に戻り得る現状の条件付き事実と矛盾する 「ccht-improve の root 未解決が続く限り」等の条件付き表現に統一し、root 解決後に main workspace 実行も回復し得る旨・improve workspace 実行の案内は保持する
3 docs/todo14.md (434-438) CodeRabbit 順位352エントリの決定件数記載 (「3 user-decisions + 5 design-decisions」計6項目) が、参照先 plan の実件数 (3 user-decisions + 4 design-decisions) とも算術上の合計とも一致しない 実際の項目数に修正するか、誤解を招く合計値を削除する。チェックリストの「全 user/design decision を照合してから plan を削除する」という要件自体は維持する

Filtered (not applicable)

該当なし (docs-only PR だが、3件とも ADR-035 の適用除外 criteria (mutation / error handling / test coverage / function length / DRY・YAGNI の code logic 視点 / magic number) に該当せず、内容の正確性・内部整合性に関する指摘のため適用対象)

次のアクション

Resolved findings:
- [Major] docs/monthly-harness-roi-review-plan.md:10 「本ドキュメントだけで実装可能」という宣言と、未確定の実装指示が矛盾しています。
- [Minor] docs/monthly-harness-roi-review-plan.md:77 「恒久的に degraded」は条件付きの現状と一致しません。
- [Minor] docs/todo14.md:438 352番エントリの決定事項の件数を修正してください。
@github-actions

Copy link
Copy Markdown
Contributor

🤖 PR Monitor 分析 (GitHub Actions バックストップ)

  • トリガー: pull_request_review (submitted) / 実行 run
  • CI: 専用 CI チェックなし (docs-only PR、変更ファイル3件すべて docs/**/*.md)。CodeRabbit チェックは pass (incremental reviews disabled のため skip)。analyze チェックは本バックストップ自身の実行中エントリ
  • レビュー状況: CodeRabbit の初回指摘 3件 (Major 1 / Minor 2) はすべて commit 03679582 の takt auto-fix で対応済み。各指摘に対し @aloekun が対応内容を返信し、CodeRabbit が3件とも "Confirmed as addressed" / "指摘は解消されています" と明示的に解決確認済み。新規指摘なし。人間レビューなし (reviewDecision 未設定)
  • Verdict: approved (未解決の applicable finding なし)

Applicable Findings (Critical / High / Major)

該当なし (該当していた1件は commit 03679582 で解消・CodeRabbit確認済み)

Applicable Findings (Medium 以下)

該当なし (該当していた2件は commit 03679582 で解消・CodeRabbit確認済み)

Filtered (not applicable)

該当なし

次のアクション

  • 前回分析時点 (13:46:19) の Major 1件・Minor 2件はすべて修正・CodeRabbit確認済みのため追加対応は不要
  • 現時点で未解決の指摘・CI失敗なし。マージ可否は引き続きユーザー判断 (reviewDecision 未設定の docs-only PR)

@aloekun
aloekun merged commit 5e5746a into master Jul 30, 2026
2 of 5 checks passed
@aloekun
aloekun deleted the docs/monthly-roi-followup-plan branch July 30, 2026 15:24
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