最終更新: 2026/06/22 18:56
commonid: drp-adr-0065-gate4-validation-reporttype: validation-reportstatus: archived
typetarget_adr: ADR-0065 (設計根拠 citation framework + Mo…draft_id: adr-0065-retroactive-validationverdict: 合格 (v1 48/50、Critical 級閾値 45 も突破、改善余地 …date: 2026-05-25
pageaudience: bothtarget_pr: PRmode: Standardthreshold: 40result_v1: 48

ADR-0065 Gate 4 Validation Report (Retroactive)

1. 経緯

ADR-0065 (設計根拠 citation framework + Mode 別網羅, Standard) は PR #934/#935 で実装先行 merge 済 (2026-05-22)、本体 ADR + retroactive prompt は PR #938 で 2026-05-22 merge。しかし「設計根拠は documented であれ」と説く本枠組み自身が ADR 未経由だった メタレベル矛盾 が残存していた。

ADR-0050/0057/0058 retroactive と同パターンで Pipeline 自己審査 (Gate 0-4) を実行し、Standard 閾値 40/50 を超えるか + Gate 3 並列レビュー指摘を取得した結果が本 report。

2. Pipeline 実行結果

  • Draft ID: adr-0065-retroactive-validation
  • Mode: Standard
  • 閾値: 40 / 50
  • 獲得スコア: 48 / 50 (Critical 級閾値 45 も突破)
  • 判定: ✅ 合格 (Standard 閾値大幅超過、初回合格)

ADR-0050 が v1 40/50 で差し戻され v2 47/50 で再合格したのに対し、ADR-0065 は v1 48/50 で初回合格 という、framework 成熟度向上を示す positive signal。

3. Gate 4 採点表 (v1)

採点項目点数コメント (Pipeline 出力)
問題定義5bus factor 45min/月、Jr onboarding 2h、AI grounding、メタ矛盾と痛みを定量化。proxy 実測は推定値だが Standard としては十分な具体性
代替案5X1/X2/X3 の 3 案 + 採択案で K.O. 通過/不通過まで明示。「テンプレのみ拡張で how-to は将来」のような中間案がないのは惜しい
判断基準5Q42 5 軸 + 係数 (×2.0/×1.0/×0.5) + K.O. criterion + スコア表で加重和 0.945 まで計算済み
過去ADR整合性5ADR-0023 (Refines) / ADR-0050 (Reuses) / ADR-0054・0058 (Pattern-aligned) と関係種別を明示
影響範囲5ADRテンプレ §7 (+18 行)、writing_design_rationale.md、Pipeline README、PR #934/#935、Jr/AI Agent まで特定
運用罠4集約パターン裁量・重複記載・新論文発見時更新リスクは挙がるが、how-to のアンチパターン 6 件の本文抜粋がなく後任が具体的にハマるシナリオを掴みにくい
ロールバック53/6/12 ヶ月の判定指標 + 4 対象の撤退手順表 (~1h) + Confirmation 3 手段で十分
コスト試算5初期 4h (内訳付)、継続 ~7h/年 (内訳付)、ROI 4h/年・12 ヶ月回収まで数値化
完了条件5docs:build 成功・行数 ≤200・onboarding ≤30 分・AI Agent dry-run と観測可能な指標を提示
長期影響4drift・重複記載リスクと撤退期限 (2026-08/11、2027-05) は明示も、明示的な Review After 日付や 1 年以降の半期レビュー継続スケジュールが弱い
合計48 / 50Standard 閾値 40 を超過、合格

4. Gate 2 整合性: INFO

## 整合性審査結果: INFO

新規 ADR (ADR-0065 retroactive 起案) は ADR-0023 / ADR-0050 / ADR-0054 / ADR-0058 を refines / pattern-align するもので、
いずれの既存決定とも矛盾しない。

- ADR-0050: Q42 MCDA / Suhr CBA を §3 で継承
- ADR-0054: 3 層構造 (テンプレ + how-to + 集約 doc) を踏襲
- ADR-0058: retroactive validation 同パターン
- ADR-0023: ADR テンプレ §7 拡張 (Mega-ADR 400 行制約内)

Supersede 宣言はないが、既存決定の上書きではなく構造的拡張であり PASS 相当に近い INFO。

5. Gate 3 並列レビュー指摘 (3 モデル)

5.1 Gemini

Strengths

  • 撤退条件 (Rollback Plan) の定量的トリガと具体的手順 → 運用後の軌道修正容易
  • ADR-0054 同型 3 層構造 → 起案者認知負荷抑えつつ標準化実現

Concerns

  • 既存 ADR 25 件超への遡及補強なし → 過去設計決定が AI Agent コンテキストから漏れ続け、新旧 ADR 間で知識サイロ化リスク
  • 集約パターン裁量・人手依存 → 引用回数カウントと集約判断を人手に頼るため、運用が進むにつれ集約漏れによるドキュメント重複負債リスク

Suggestions

  • Frontmatter に機械可読 citations: [DOI/URL] 追加 (AI grounding をより確実に)
  • 全件遡及困難なら Critical 過去 ADR 3-5 件に絞って優先補強の方針追記

5.2 Claude

Strengths

  • ADR-0054 先例パターンとの明示的整合 → メタ規約としての一貫性と説得力
  • ROI 定量化 (~12 ヶ月回収) → 意思決定の透明性 (bus factor 9h/年 の算定根拠を §1.3 と整合性明示すると更に良い)

Concerns

  • Status: Proposed vs main 統合済の論理的矛盾 → Status: Accepted (retroactive) 等に明確化すべき、「不採用なら revert」の現実コストが §6 撤退手順に十分反映されていない
  • #suitable 採点 (X1=4 vs 採択案=5) の差別化根拠が不明 → テンプレ +18 行は既存からの逸脱でもあり、評価軸の解釈が採択案有利にバイアスしていないか検証必要 (Suhr 重み操作批判の典型例の疑い)
  • 3 ヶ月後撤退条件 (起案者自身の「重い」申告 1 件以上) → 起案者が単独 Decider なら自己申告バイアスで機能しにくい、客観指標 (§7.2 空欄率、月次レビュー時 citation 不備率) 併設すべき
  • 6 ヶ月後撤退条件 (writing_design_rationale.md 参照率 < 80%) → 参照率測定方法未定義、GitHub アクセスログは取れず事実上発火不能
  • 1 年後撤退条件 (Jr 入社 1 人前提 n=1 で 30 分閾値判定) → 統計的脆弱、複数指標 (通読完了率、質問件数) 組合せか閾値根拠明示が必要

Suggestions

  • 撤退手順 ~1h 見積もりに「既存 ADR で §7.2 を埋めたものをどう扱うか (残す/削る)」「Decision Pipeline README から本パターンに依存して書かれた他章の整合性」を含めて波及範囲詳細化
  • 「URL 生成禁止」が AI Agent grounding 文脈で重要なら、本 ADR 内でその意図 (ハルシネーション URL 防止) と運用ルールを短い注記で追加
  • lint 化将来検討トリガ明記 (例: 違反 ADR 累計 5 件超えたら) → 後続 ADR 引き継ぎ明確化
  • 評価軸の公平性疑念払拭のため、案 X1 のスコア (#suitable=4) を採択案 5 と差別化した根拠を一文添える

5.3 GPT (o3)

Strengths

  • 既存成功パターン (ADR-0054) 再利用で実装不確実性低減 + 学習コスト抑制
  • 撤退条件の明確な期限付きメトリクス
  • ROI 定量化 (~12 ヶ月回収)

Concerns

  • Implementation Status: Not Started の記述があるが PR 統合済との矛盾 → ステータス管理が不透明、進捗管理リスク
  • 月次 review 5 件サンプリングは検証が人手依存 + 観測頻度が低くドリフト早期検知困難
  • citation 選択コスト ~5min は楽観的 → DOI 取得や書誌情報整形は実務で 10-15 min かかり、ROI が過小評価
  • Light Mode 自己申告で要件回避できる抜け道 → 全体整合性目標毀損リスク
  • citation 5 タイプにデータセット・GitHub repo 等が欠落 → 早期に例外運用発生懸念

Suggestions

  • citation lint CI 先行実装 → 月次手動サンプリング削減 + 完了条件検証性向上
  • Implementation Status 矛盾解消 (PR マージ前なら Draft、マージ済なら Implemented など正確なフェーズに更新)
  • 5 タイプに「その他」スキーマと追加申請プロセスを用意 → 新種別追加時の運用コスト抑制

6. 本 PR で対応した v2 改善 (2 項目)

6.1 運用罠 (4/5 → 改善見込 5/5)

ADR-0065 §5.4 に 「後任がハマる典型シナリオ (運用罠の抜粋)」 セクション新設:

  • writing_design_rationale.md §6 アンチパターン 6 件のうち、後任が最も陥りやすい 3 件 (「あの論文」記憶ベース / 「ぽい URL」生成 / 同一 FW 重複記載) を本文に抜粋
  • 残り 3 件は how-to 参照誘導

6.2 長期影響 (4/5 → 改善見込 5/5)

ADR-0065 §6.2 に 「Review After 半期スケジュール」 セクション新設:

  • 6 つの明示的 Review 日付 (2026-08-23 / 2026-11-23 / 2027-02-23 / 2027-05-23 / 2027-11-23 / 2028-05-23) と各日のレビュー対象・担当・期待アウトプットを表形式で確定
  • 参照率測定方法 (Gate 3 Claude 指摘対応) として 3 種の代替指標を明示

7. 残る将来課題 (合格後の improvement 候補、本 PR 範囲外)

項目元指摘想定対応時期対応 ADR 候補
機械可読 frontmatter citationsGemini suggestion2028-05-23 総括citation 5 タイプ拡張 ADR と統合
評価軸バイアス検証Claude concern (#suitable)ADR-0050 改訂時ADR-0050 v2 改訂
citation コスト試算更新GPT concern (5min vs 実務 10-15min)2026-08-23 体感確認ADR-0065 v3 候補 (Light 改訂)
lint CI 先行実装GPT suggestion2027-11-23 トリガ判定別 ADR で起案
Critical 過去 ADR 遡及補強Gemini concern (サイロ化)2027-05-23 総括別 ADR で対象選定

8. メタ示唆

ADR-0065 が v1 48/50 で初回合格 したことは、ADR-0050 (v1 40/50 → v2 47/50) と比較すると framework 成熟度向上の示唆:

  1. 評価軸の継承効果: Q42 5 軸 + 係数を ADR-0050 から継承して起案初稿から組み込み済み → 「判断基準」5/5
  2. 撤退条件・コスト試算の初稿明確化: ADR-0050 v1 で不足だった項目を最初から記載 → 「ロールバック」「コスト試算」各 5/5
  3. Pattern-aligned 関係の活用: ADR-0054 (3 層構造) / ADR-0058 (retroactive) を Pattern-aligned で参照 → 「過去ADR整合性」5/5

これは Decision Pipeline framework 自身の continuous improvement (ADR-0050 → 0054 → 0058 → 0065) が実 ADR 起案品質の底上げに寄与している positive signal。

9. 関連リソース

  • 起案プロンプト: docs/_internal/03_decisions/decision_pipeline/ADR-0065_retroactive_validation_prompt.md
  • ADR 本体: docs/adr/0065-establish-design-rationale-citation-framework-and-mode-based-coverage.md
  • how-to (参照対象): docs/_internal/05_how-to/writing_design_rationale.md
  • 先例 (Critical 級): docs/_internal/03_decisions/decision_pipeline/ADR-0050_gate4_validation_report.md
  • 関連 PR: #934 (Decision Pipeline README §設計根拠章), #935 (ADR テンプレ §7.2 + writing_design_rationale.md), #938 (ADR-0065 本体 + retroactive prompt)