• Status: Proposed
  • Mode: Critical
  • Kruchten Type: Existence/Executive
  • Scope: platform
  • Implementation Status: Not Started
  • 起案者: [email protected]
  • 起案日時 (JST): 2026-07-06 17:59
  • 承認日時 (JST): -
  • Approver Role: platform
  • Approver Who: [email protected]
  • Driver: [email protected]
  • Consulted: Decision Pipeline AI 審査 (Gate 0-4)

1. Executive Summary

  • 文脈: 起案者・Jr (2026-10 入社)・業務委託が公開ドキュメントサイト (docs.bizlp.dev) を閲覧中に、方針の元となる過去判定や類似論点の過去 RQ を確認したい場面がある。
  • 課題: docs 閲覧中に過去判定の根拠を引ける情報が別 UI (起案者専用の壁打ちチャット) にしかなく、外部 AI を別タブで開く画面切替が 1 質問 30-60 秒 × 5-10 質問/session = 3-10 分/session の遅延を生む (月次 10-20 session で 30-200 分累積 · 過去の実測データに基づく)。
  • 対策: 公開ドキュメントサイトを Cloudflare Access (Google Workspace SSO) で社内限定化し、docs chatbot 用 endpoint に archive-mcp の retrieve_evidence tool を接続して社内一次情報 (過去の決定記録、要求事項、ドキュメント、テレメトリーデータ、会話履歴) 全 source を引ける多源 RAG に統合する。
  • 効果: docs 閲覧中に社内一次情報を即参照でき、月次画面切替遅延を 30-200 分から 5-15 分に削減する (5-15 倍削減) · docs 単源 vs 多源の回答品質を 3 ヶ月並行で定量比較。
  • 代償: 公開ドキュメントサイトの一般公開を放棄し SSO ユーザーのみアクセス可 (社外閲覧者ゼロ · Jr/委託参画時に SSO account 発行必要) + 実装工数 15-24h + 月額課金増分 $5-15/月 (既存の関連 ADR の上限 $80/月 の 6-19%)。

2. 何を解決するか

2.1 直面していること

適合性:

  • 過去 ADR の数値根拠を当てたい時に外部 AI を別タブで開いている (n=1 実測 2026-07-03 で 5-10 質問/session)。
  • 起案者専用の壁打ちチャットは起案者のみ使用可で、docs 閲覧中の Jr/委託は使えない。
  • 月次 10-20 session · 3-10 分/session × 頻度 = 30-200 分/月 (n=1 proxy)。

効率性:

  • docs 単源の検索経路と多源の検索経路が独立稼働し、docs 閲覧経路と壁打ち経路の RAG 品質差が累積する。
  • ADR-0069 §10.2 で「Phase R2 (多源 RAG) への段階拡張パスを設計上担保、R1 vs R2 の回答品質を比較可能化」と明示済で、本 ADR は Phase R2 に対応する。

セキュリティ:

  • docs.bizlp.dev は現状 IP rate limit のみで、経路上は外部からも docs 内容にアクセス可能な状態。

2.2 放置すると起こること

適合性:

  • Jr 入社 2026-10 で閲覧者が 3 倍 (1 → 3 名) になれば、月次画面切替遅延は 90-600 分/月に拡大する見込。
  • docs 単源経路と多源経路の品質差が拡大し、閲覧者ごとに参照精度が分岐する。

効率性:

  • docs 単源 Vectorize (ADR-0069) と多源 archive-mcp (ADR-0169) の 2 系統併存が固定化し、RAG chain 1 本化の意思決定が延期され続ける。

2.3 潜在リスク

セキュリティ:

  • archive_us 全 source (過去判定 · 会話履歴を含む) を docs chatbot に接続する場合、archive-mcp 側の decision-time フィルタだけでは吸収しきれず、UI 境界での明示的分離が必要になる可能性 (発生確率不明 · 実害未発生)。

3. 採用したい方針

3.1 対策方針

docs.bizlp.dev を Cloudflare Access + Google Workspace SSO で bizlp.co.jp domain allowlist 認証必須化し、drp/src/routes/chat_docs.ts (= docs chatbot の LLM handler) に archive-mcp の retrieve_evidence tool 呼出を追加する。archive-mcp 側の decision-time フィルタは認証済ユーザー向けに条件緩和し、docs 閲覧中に多源 RAG を引ける状態を Phase R2 として実現する。ADR-0069 の docs 単源 Vectorize は 3 ヶ月併存で回答品質を比較し、多源優位が確認されたら退役する (退役 sub-phase を本 draft 内で便宜 Phase R2b と呼称 · ADR-0069 §2.3 の Phase R3 とは別)。

  • セキュリティ: Cloudflare Access で docs.bizlp.dev の全経路を保護し、認証済メール domain (bizlp.co.jp) のみ通過させる。
  • 適合性: retrieve_evidence の tool 呼出を既存 Vectorize 検索と組み合わせて hybrid retrieval 化する (RRF k=60)。
  • 効率性: archive-mcp の既存 IAM (bigquery.dataViewer/jobUser + aiplatform.user + discoveryengine.viewer) を流用し、追加 IAM 設定なしで統合する。

3.2 守るべき設計制約

  • セキュリティ: 認証未通過ユーザーに対して社内一次情報を露出させない (Cloudflare Access で全経路を gate)。
  • 効率性: archive-mcp 側月額上限は ADR-0169 §7 の $80/月に収める (docs chatbot 経由の追加 query は月 100-300 想定 · +$5-15/月見込)。
  • 保守性: 3 系統 (壁打ち経路 · docs 単源経路 · 多源経路) の使い分け runbook (ADR-0169 §4 で新設予定 docs/_internal/06_ops/intake_chat_rag_runbook.md (= 壁打ちチャットの RAG 運用手順書)) に docs chatbot 経路を追記する。
  • 適合性: docs chatbot と壁打ちチャットは UI として別存し、「読み手向け」「起案者向け」の役割分離を維持する (ADR-0164 (intake サイト分離) 整合)。

3.3 仕様

  • セキュリティ: Cloudflare Access Zero Trust free plan (50 users まで無料) · Google Workspace SSO · bizlp.co.jp domain allowlist · Access group で Jr/委託を個別追加 · session TTL 24h。
  • 適合性: drp/src/routes/chat_docs.tsretrieve_evidence tool 定義を追加し、tool 呼出 1 turn で Vectorize と archive-mcp を RRF k=60 で hybrid 統合する。
  • 効率性: Check Grounding API (= 引用の裏取り検証 API) で citation 検証し、根拠のない引用 (fake citation) が > 1% で revert する (ADR-0069 §5.4 準拠)。
  • 保守性: docs 単源 Vectorize は Feature flag DOCS_SEARCH_LEGACY_ENABLED (= docs 単源経路の有効/無効切替フラグ · default true) で 3 ヶ月併存し、Phase R2b で false 切替後に退役する。

4. 判断基準

4.1 評価軸 (5 個選定)

#軸 (Q42)日本語軸名重要度 (係数)案件特有の解釈
1#secureセキュリティMust (×2.0)Cloudflare Access で docs.bizlp.dev 全経路を SSO 認証必須化 · 認証未通過での社内一次情報露出はゼロ · K.O. = 認証迂回経路が残存
2#suitable適合性Must (×2.0)docs 閲覧中に社内一次情報を引ける (fixture 20 query · ADR + RQ + 過去判定の citation 精度 ≥ 80%) · K.O. = citation 精度 < 70%
3#efficient効率性High (×1.0)retrieve_evidence 遅延 P95 ≤ 3.0s · docs chatbot 経由の月額追加課金 ≤ $15/月 · 全体 ≤ $80/月
4#operable運用性Medium (×0.5)3 系統 runbook 統合負荷 · Cloudflare Access user 管理 · Jr/委託 SSO account 発行手順
5#maintainable保守性Medium (×0.5)docs 単源 Vectorize を 3 ヶ月併存後退役し、RAG chain を 1 本化

K.O. criterion: Must 軸 score < 3 は不採用。

  • セキュリティ score < 3 (認証迂回経路が残存 · 全経路 gate 未達)
  • 適合性 score < 3 (fixture 20 query citation 精度 < 70%)

4.2 評価軸 × 案スコア表

各案 0-5 で評価。加重和 = (Σ score × 係数) / (満点 × Σ 係数) で正規化 (0.0-1.0)。

係数案 1 (採用: 社内限定+全 source)案 2 (不採用: 一部 source)案 3 (不採用: 現状継続)案 4 (不採用: 公開+filter)
セキュリティ×2.05341
適合性×2.05314
効率性×1.04353
運用性×0.53353
保守性×0.54222
加重和 (正規化)0.9000.5800.6200.500
K.O. 通過 (Must ≥3)❌ (適合性=1)❌ (セキュリティ=1)

加重和は K.O. 通過候補のタイブレーク用 (Suhr 1999 CBA 準拠)。

5. 検討した代替案

5.1 案 1 (採用): docs chatbot 社内限定化 + archive-mcp 全 source 直接接続

  • セキュリティ: Cloudflare Access で境界を UI 層に統一し、archive-mcp 側のフィルタ緩和を認証済ユーザーに限定する。
  • 適合性: 社内一次情報の全 source を引けて、壁打ちチャット相当の網羅性を docs 閲覧経路で実現する。
  • 効率性: 実装 15-24h · 月額 +$5-15 · 既存 archive-mcp / Cloudflare Workers インフラを流用する。

5.2 案 2 (不採用): docs chatbot は認証不要のまま社内一次情報の一部 source (ADR + RQ + docs) のみ接続

  • セキュリティ: source allowlist (過去の判定記録や会話履歴を除外) の filter 実装が必要で、filter バグで機密漏洩リスクが残存する。
  • 適合性: 過去の判定記録や会話履歴を引けず、過去審査結果に基づく引用ができない (fixture citation 精度は案 1 より 15-25 pt 低い見込)。
  • 効率性: source allowlist filter 実装 5-8h 追加 + 継続的な filter 保守負荷が発生する。

5.3 案 3 (不採用): docs 単源 (ADR-0069 現状) 継続 · 壁打ちチャットで多源引用

  • セキュリティ: 現状維持で認証境界そのまま。
  • 適合性: docs 閲覧中 (Jr/委託) は多源引用にアクセスできず、課題未解決のまま残る。
  • 効率性: docs 閲覧 → 壁打ちチャット移動の画面切替遅延が継続する (30-200 分/月)。

5.4 案 4 (不採用): docs.bizlp.dev 一般公開のまま全 source 接続 (サーバ側 filter で機密除外)

  • セキュリティ: サーバ側 filter 破綻時に機密 (過去の判定記録や会話履歴) が公開経路経由で漏洩する (K.O. = セキュリティ score < 3)。

5.5 案 5 (不採用): 2026-10 Jr 入社後 1 ヶ月の実利用データ (n≥3) 取得を待ってから Phase R2 実装

  • 適合性: Jr 入社後の実利用パターンを観察して fixture 20 query の選定精度を上げられる利点はあるが、Jr onboarding 期間 (2026-10-01 〜 2026-10-末) 中に既存 docs のみ提示すると、Jr が起案者に質問を繰り返して起案者の作業中断が増える (画面切替遅延の 3 倍拡大予測 = 課題 §2.2 の悪化を Jr 入社直後に受ける)。
  • 効率性: 実装遅延 3 ヶ月で ROI 発生も 3 ヶ月遅れる (画面切替遅延削減 24-40h/年 × 0.25 年 = 6-10h 機会損失)。
  • 保守性: 遅延中も docs 単源 (ADR-0069) と壁打ち多源 (ADR-0169) の 2 系統併存が継続し、RAG chain 1 本化の判断が更に遅延する。

6. 影響

6.1 正の影響

  • セキュリティ: docs.bizlp.dev の外部露出を撤廃し、社内文脈 (Jr onboarding docs · 業務委託向け内部規約) の意図しない外部公開リスクをゼロ化する。
  • 適合性: docs 閲覧中の社内一次情報引用が可能になり、ADR-0169 Phase 3 で実測 gold 50 query recall@10 = 1.000 の性能を docs chatbot でも享受する。
  • 効率性: 月次画面切替遅延を 30-200 分 → 5-15 分に削減する (5-15 倍削減 · Jr 入社後 n≥10 収集で信頼区間補正 · 2027-01-03 レビューで再評価)。
  • 保守性: RAG chain の 1 本化パスを 3 ヶ月併存 → 退役判断で確定し、docs 単源 vs 多源の定量比較データを蓄積する。

6.2 負の影響 / リスク

  • セキュリティ: Cloudflare Access 障害で docs 全経路が閲覧不能になる新規リスクが発生する (撤退条件 §8-5 で SLI 監視)。
  • セキュリティ: 撤退条件発火で一般公開に revert する際、Cloudflare Vectorize index は Access policy 適用外で index 内容が embedding として残存するため、revert 前に Vectorize index の全 vector 削除 or index 無効化が必須になる (§8-1 で手順を明示 · Cloudflare 公式「Indexes are not protected by Access policies」)。
  • セキュリティ: 社内限定化前に Google Search Console + CDN アクセスログで外部参照実績 (採用サイト · 取引先 domain 等) を 1 週間計測し、外部参照が月 50 PV 超なら公開サブパス (/public/*) を Access 適用外にする設計変更を Phase 0 実装前ゲート (§9-8) で判定する。
  • 運用性: Jr/委託参画時に SSO account 発行 + Access group 追加が必要になり、手順を intake_chat_rag_runbook.md に明記する。
  • 運用性: Cloudflare Access の SSO ループ障害 (IdP 側 OAuth token 失効 + Access キャッシュ不整合) はユーザー自己解消不可で管理者の Access group 再操作が必要になるため、自己復旧手順とエスカレーション条件 (30 分以内に解消しない場合) を runbook に明記する。
  • 効率性: Cloudflare edge → Cloud Run archive-mcp の WAN 遅延 + Cloud Run コールドスタート (平均 1.2s · P95 3.5s Google 公開ベンチマーク) が加算されると P95 3.0s KPI を常時超過する可能性があるため、Cloud Run 最小インスタンス 1 vs keep-alive ping のコスト実測を Phase 1 完了時 (2026-08-末) に実施し撤退条件 §8-4 閾値 (5s → 3s 前倒し) の要否を確定する。
  • 効率性: Jr 1 名 + 委託 1 名参画で query 数が単純 3 倍 (300-900 query/月) になり、900 query × $0.05 = $45/月 + ADR-0169 5,000 query 時 $60-70/月 = $105-115/月で撤退条件 §8-2 ($85 超 2 ヶ月連続) が発火するリスクがあるため、悲観値シナリオを §7.2 に明記した (Jr/委託がアクセスする際は多源経路利用制限も選択肢)。
  • 保守性: docs 単源 Vectorize と多源 archive-mcp を 3 ヶ月併存し、品質比較データ収集の観測工数が ~1h/月発生する。
  • 保守性: n=1 実測ベース ROI 推計 (画面切替遅延 30-200 分/月) は実効果を 2-3 倍過大評価する傾向があるため、Jr 入社後 1 ヶ月時点 (2026-11-03) で chatbot 実利用セッション数 ≥ 5/月を確認し未達なら Phase R2b 移行を自動凍結する (§9-7 で定量トリガー化)。

7. コスト試算

7.1 前提条件

項目根拠
docs chatbot 月次 query 数 (楽観 · n=1 外挿)100-300docs 単源現状 30-60 → 多源化で 3-5 倍増想定
docs chatbot 月次 query 数 (悲観 · Jr+委託 3 倍)300-900100-300 × 3 名 (起案者 + Jr + 委託)
retrieve_evidence tool 呼出単価~$0.05/queryBQ retrieve + Vertex Ranking + Gemini grounded (ADR-0169 §7.1 準拠)
Cloudflare AccessFree tier 50 users1 人法人 + Jr + 委託 ≤ 5 users で無料 (Zero Trust free plan)

7.2 月コスト試算

  • 実装工数: 15-24h (Cloudflare Access 4h + retrieve_evidence tool 統合 8-12h + UI 更新 3-5h + runbook 追記 2-3h) · レビューバッファ +30% で 20-32h。
  • 継続運用: Cloudflare Access user 管理 ~10min/月 + runbook 更新 ~30min/月 + 品質比較データ観測 ~1h/月 = ~22h/年。
  • 月額課金増分 (楽観): retrieve_evidence tool 呼出 100-300 query × $0.05 = $5-15/月 (ADR-0169 上限 $80/月 の 6-19%)。
  • 月額課金増分 (悲観 · Jr+委託 3 倍): 300-900 query × $0.05 = $15-45/月
  • 総月額 (楽観 · 500 query 換算): 現状 ADR-0069 ~$0 + ADR-0169 実測 $6-7 + 本案 $5-15 = $11-22/月
  • 総月額 (悲観 · Jr+委託 3 倍 + ADR-0169 5,000 query 換算): 現状 ADR-0069 ~$0 + ADR-0169 $60-70 + 本案 $15-45 = $75-115/月 ($85 超は撤退条件 §8-2 で発火 · Jr や業務委託が参加する際に、多源経路へのアクセス制御ポリシーを適用することを検討する)。
  • ROI: 削減 ~24-40h/年 (画面切替遅延 30-200 min × 12 ヶ月) − 継続 22h/年 = net +2 to +18h/年 · 実装工数 20-32h の回収期間 12-32 ヶ月 (n=1 実測ベースのため実効果は 2-3 倍過大評価の可能性 · §9-7 で Jr 入社後実測により再評価)。

8. 撤退条件

  1. セキュリティ違反: Cloudflare Access の認証を迂回する経路が発見された場合 → 即時 docs chatbot 停止 · retrieve_evidence tool 撤退 · docs.bizlp.dev の一般公開に revert (revert 前に Vectorize index の全 vector 削除 or index 無効化を完了 · e2e test access-gate.spec.ts と同等の事前検証対象 · Cloudflare Vectorize は Access policy 適用外で index 内容が残存するため必須手順)。
  2. 月額上限超過: archive-mcp + docs chatbot 追加 query で $85/月超過が 2 ヶ月連続 → source scope 縮小 (過去判定/会話履歴除外の案 2 後退) or docs chatbot 経路のみ Feature flag DOCS_CHATBOT_MULTI_SOURCE_ENABLED (= docs chatbot の多源経路有効フラグ) で off · Jr/委託の多源経路利用制限ポリシー適用。
  3. citation 精度 < 70%: fixture 20 query で citation 精度が 70% 未満 (人間評価 · 3 ヶ月後 2026-10-03) → docs 単源に revert · 案 2 (一部 source) 再検討。
  4. retrieve_evidence 遅延 P95 > 5s (Phase 1 完了時 2026-08-末 の Cloud Run コールドスタート実測で 3s 前倒し要否を確定): 1 ヶ月継続 → tool 呼出 turn 数削減 or archive-mcp 側の索引再構築 · Cloud Run 最小インスタンス 1 vs keep-alive ping のコスト実測結果を本 ADR frontmatter Review After (2026-08-末) で追記反映。
  5. Cloudflare Access 障害で docs 閲覧不能 > 30 min/月: 承認者 = 代表取締役 ([email protected]) の判断で SSO 一時撤退 + docs.bizlp.dev 一般公開に戻す。全断 60 分以上継続時は承認不要の自動 revert 条件として発火 (revert 前に §8-1 と同じ Vectorize index 削除手順を実行) · revert 後の外部露出許容最大時間は 24h で intake_chat_rag_runbook.md に事後対応手順 (再限定化 · 監査ログ確認) を明記 · 社内限定化の再着手は本 §8-5 発動 (SSO 一時撤退 + docs.bizlp.dev 一般公開に戻す確定) から 30 日以内に新規 ADR を起案 する (ADR-0130 起票義務 pattern · Cloudflare Access 障害の恒常化根拠 + 復元計画 + 撤退条件 trigger の再定義を含む)。

9. Confirmation

  1. Cloudflare Access 認証通過率: docs.bizlp.dev アクセスログで認証通過率 100% · 未認証アクセスは Access ログで即時検知 · 実行頻度 = 月次 · 違反時対応 = §8-1 撤退条件で全経路 gate を再確認。
  2. retrieve_evidence tool 呼出成功率: docs chatbot log で成功率 > 95% · 失敗は Cloudflare dashboard アラート · 実行頻度 = 週次 · 違反時対応 = archive-mcp の log ベースアラート経由で email 通知 → 手動 debug。
  3. DOCS_SEARCH_LEGACY_ENABLED という機能フラグ の 3 ヶ月併存監視: Feature flag が true (docs 単源 Vectorize 併存) のまま Phase R2b (docs 単源退役) 移行判定を保留していないかを確認 · 実行頻度 = 月次 · 違反時対応 = §11 実装配線の Phase R2b 移行 checklist で ADR-0147 (docs-vectorize auto-ingest) workflow の disabled 化タイミングを再議。
  4. 20 個の固定クエリに対する引用精度: 3 ヶ月毎に人間評価 (2 名独立評価 · 代表取締役 + AI Agent · disagreement < 10% で正規化) · > 80% · 実行頻度 = 3 ヶ月毎 (2026-10-03 · 2027-01-03) · 違反時対応 = §8-3 撤退条件で docs 単源 revert。
  5. 月額 archive-mcp コスト: LiteLLM ログ + Cloud Monitoring で docs chatbot を経由した追加のクエリコスト を集計 · < $15/月継続 (楽観) or < $45/月 (Jr+委託 3 倍後の悲観許容) · 実行頻度 = 月次 · 違反時対応 = §8-2 で source scope 縮小。
  6. docs 単源 vs 多源比較 (3 ヶ月データ): query log で回答品質 (citation 精度 + 応答時間 + 未回答率) を比較 · 実行頻度 = 3 ヶ月時点 (2026-10-03) · 違反時対応 = 多源優位が有意 (p < 0.05 · Wilcoxon signed-rank) なら docs 単源退役、そうでなければ併存継続で 6 ヶ月時点 (2027-01-03) に再判定。
  7. Jr 入社後実利用セッション数 (ROI 過大評価防止トリガー): Jr 入社後 1 ヶ月時点 (2026-11-03) で chatbot 実利用セッション数 ≥ 5/月 · 実行頻度 = 単発 (2026-11-03) · 違反時対応 = 未達なら Phase R2b (docs 単源退役) 移行を自動凍結し、docs 単源併存を 6 ヶ月まで延長 · サンクコスト前提での退役判断を阻止。
  8. 外部参照実績計測 (社内限定化前ゲート): Cloudflare Access 適用前 1 週間、Google Search Console + CDN アクセスログで外部参照元 (採用サイト · 取引先 domain 等) の PV 数を計測 · 実行頻度 = 単発 (Phase 0 実装前) · 違反時対応 = 外部参照が月 50 PV 超なら公開サブパス (/public/*) を Access 適用外にする設計変更を §3.3 仕様に追記してから実装開始。

10. 参照

10.1 関連 ADR

  • Refines: ADR-0069 (docs 単源 RAG chatbot MVP を Cloudflare Workers + Vectorize で構築) — docs 単源 → 多源 Phase R2 拡張 (ADR-0069 §1.4 で「多源 R2 は将来別 ADR」明示済)。
  • Refines: ADR-0169 (壁打ちチャットに根拠引用 RAG を追加) — archive-mcp Cloud Run service を docs chatbot からも呼べる経路として拡張。
  • Depends on: ADR-0167 (BQ アーカイブ dataset を US 化) — archive_us schema (gemini-embedding-001 768d MRL) を継承。
  • 関連: ADR-0164 (intake サイト分離) — docs chatbot と壁打ちチャットの UI 分離を維持。
  • 関連: ADR-0142 (Pregate 簡易判定) — 月額 $80 上限との整合。
  • 関連: ADR-0155 + ADR-0211 Step 4 (2026-07-06 shipping) — docs chatbot Worker から archive-mcp Cloud Run を service-to-service で叩く時の Cloudflare Access service token (client_id / client_secret) の secret 経路は GCP SM 側で ADR-0211 と整合する (エンドユーザ認証は本 ADR で新設する別経路で secret 管理対象外)。
  • 関連: ADR-0147 (docs-vectorize auto-ingest) — docs 単源退役時の script 処理経路。
  • 関連: ADR-0053 (判断基準 MCDA 強制) — §4 で MCDA 加重和法を適用。

10.2 関連 PR/Issue

  • (該当なし · 実装 PR は本 ADR 受理後に起票)

10.3 外部資料

  • Cloudflare Zero Trust Access ドキュメント (Google Workspace SSO 接続の runbook)
  • Cloudflare Vectorize ドキュメント (「Indexes are not protected by Access policies」記載 · revert 手順で Vectorize index 削除が必要な根拠)
  • Google Cloud Run cold start ベンチマーク (平均 1.2s · P95 3.5s · Cloud Run 最小インスタンス 1 の判断根拠)
  • Cloudflare Zero Trust 2023-06-12 障害事例 (影響約 2 時間 · §8-5 撤退条件の閾値設定根拠)
  • Suhr 1999 CBA criterion · arc42 Q42

11. 実装配線

  • lint 配線: scripts/adr-lint-doc-consistency.mjs (= ADR 間の記述整合を検査する lint) に「本 ADR 受理後 ADR-0069 implementation_status を Refined by 化」の consistency check を追加 · drp/src/routes/chat_docs.tsretrieve_evidence tool 統合を検証する unit test を drp/test/routes/chat_docs.test.ts (= docs chatbot handler の単体テスト) に新設 · Cloudflare Access 認証中間処理の e2e test (drp/e2e/access-gate.spec.ts (= 認証境界の end-to-end テスト)) を新設 · 撤退時 Vectorize index 削除スクリプト (scripts/vectorize-purge.mjs) を新設し access-gate.spec.ts と同等の事前検証対象として ADR 受理時に配線。
  • 起案フロー配線: docs/_meta/templates/adr-draft.template.md (= ADR 起案 template) §11 実装配線の例示に「docs chatbot と壁打ちチャットの 2 経路 RAG 分離」を追加 · docs/_internal/06_ops/intake_chat_rag_runbook.md (ADR-0169 §4 で新設予定) に docs chatbot 経路 · SSO ループ時自己復旧手順 (キャッシュクリア → 再認証 URL) · 管理者エスカレーション条件 (30 分以内に解消しない場合) · 撤退時 Vectorize index 削除手順 · 一般公開 revert 承認者と自動 revert 条件 · 外部参照実績計測 (Phase 0 ゲート) を追記 · .claude/rules/docs.md (= docs 系ルール SSoT) に「docs chatbot は SSO 認証必須」を追記。
  • docs SSoT 同期: docs/architecture/README.md の docs chatbot 節に社内限定化を明示 · docs/_internal/05_how-to/workspace_rules.md の docs 系行に SSO 認証必須を備考追加 · docs/adr/0069-docs-single-src-rag-bot-cf-workers-vectorize-mvp.md の implementation_status に「Refined by 本 ADR (Phase R2 = docs 閲覧経路の多源 RAG 統合)」を本 ADR 受理時に追記する (ADR-0069 §2.3 で Phase R1 / R2 / R3 と定義済 · 本 draft は R2 対応 = Refines 関係 · Supersede ではない)。docs 単源退役 (本 draft の Phase R2b sub-phase) 実施時に ADR-0147 の docs-vectorize.yml (= docs Vectorize 自動投入 workflow) を disabled 化 (schedule 停止 + secrets 撤退) + ADR-0147 frontmatter の refined_by に本 ADR を追記する。