From f3c3daada05174453d5b1c84b6c4fa3235544e05 Mon Sep 17 00:00:00 2001 From: aloekun Date: Fri, 31 Jul 2026 01:30:58 +0900 Subject: [PATCH] =?UTF-8?q?docs(adr-062):=20degraded=20=E3=82=BB=E3=83=9E?= =?UTF-8?q?=E3=83=B3=E3=83=86=E3=82=A3=E3=82=AF=E3=82=B9=E6=96=87=E6=9B=B8?= =?UTF-8?q?=E5=90=8C=E6=9C=9F=20=E2=80=94=20extra=5Froots=20=E3=81=AF?= =?UTF-8?q?=E9=9B=86=E8=A8=88=20root=20=E8=BF=BD=E5=8A=A0=E3=81=AE?= =?UTF-8?q?=E3=81=BF=20(Phase=20B)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR #333 の degraded 保守化 (extra_roots では degraded を解除しない) の文書波及漏れを解消する。 - § 決定 5: last-run 契約の「degraded は improve 実行 / extra_roots 追加で解消」を 「improve 実行で解消 (extra_roots は集計 root 追加のみで degraded は解除しない)」に訂正。 § 決定 2 は PR #333 で更新済みのため旧括弧書きは偽になっていた。 - § 決定 2: 運用帰結 (格納パス不整合が続く限り main は恒久 degraded / improve 実行が唯一の 非 degraded 経路) を 1 文明記。 skills repo monthly-review/SKILL.md の 3 箇所 + 誤字 (ADR-028 ゲット→ゲート) は当該 repo で別途 commit 済み (deployed へ cp 同期・in-sync 確認済み)。memory monthly-review-degraded-from-main-workspace は PR #333 保守化と整合済みのため確認のみ。 ADR-062 --- docs/adr/adr-062-monthly-harness-roi-review.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/adr/adr-062-monthly-harness-roi-review.md b/docs/adr/adr-062-monthly-harness-roi-review.md index 79275140..ff6c1a52 100644 --- a/docs/adr/adr-062-monthly-harness-roi-review.md +++ b/docs/adr/adr-062-monthly-harness-roi-review.md @@ -84,7 +84,9 @@ weekly-review にあった `.failed` marker / resume 機構は**不採用**と promote 抑止となる (leak 発火が improve 偏在のため誤 promote を防ぐ正しい挙動)。degraded を解消する 運用は **improve workspace から実行する** (improve が現 root として解決される)。`extra_roots` は 集計対象 root を追加する (improve の telemetry を取り込む) が、未解決 workspace の root は未知で - 対応を検証できないため degraded の解除には使わない。 + 対応を検証できないため degraded の解除には使わない。**この格納パス不整合が続く限り main workspace + からの実行は恒久的に degraded であり、improve workspace からの実行が唯一の非 degraded 経路である** + (last-run 更新契約 § 決定 5 により、main からは L1 reminder が止まらない)。 - **月次 rollup + retention**: 月ごとの id 別集計を `.claude/telemetry/monthly-.json` (main workspace 側) に永続化。raw daily ファイルは retention (config `retention_days`。**code default は未設定 = 削除無効**、ADR-039 opt-in。本 repo は `retention_days = 90` で dogfood) 超過分を @@ -156,7 +158,8 @@ skills repo (`$CLAUDE_SKILLS_REPO`) で作成し `~/.claude/skills/` へ deploy に到達しない) と **degraded** (root 発見不完全で promote 抑止) の場合は last-run を**更新せず stale のまま**にし、次回セッションで L1 reminder を再発火させる。degraded を「レビュー完了」と みなして更新すると、root 発見漏れ (leak 発火が improve に偏在) のまま催促が止まるため。degraded は - improve workspace 実行 / `extra_roots` 追加で解消するまで催促を継続する (§ 決定 2 の運用指針と整合)。 + **improve workspace 実行で解消するまで催促を継続する** (`extra_roots` は集計対象 root を追加する + のみで degraded は解除しない)。 - **候補が 4 件を超える場合は AskUserQuestion を複数質問に分割**する (1 質問 4 option の制約。 severity / 機構種別順にグループ化。ADR-031 Phase E dogfood で確立した weekly-review と同方式)。 - 自動で無効化しない。採否は必ず AskUserQuestion を経る