役割: DRP(意思決定 審査パイプライン)固有用語の JA↔EN 対訳と定義の SSoT〔Single Source of Truth=唯一の正データ〕。
棲み分け: bizlp プロジェクト全体の用語(INV / STL / Action A・B / HITL 等)は 全体用語集 が正典。本書は DRP スコープの用語のみ定義し、全体用語集と重複させない。
初見の読者へ: 本書 → ID 規約と L1〜L4 分類 → 文書カタログ の順で読む。
1. パイプライン全体
| 用語 (JA) | 用語 (EN) | 定義 | 関連 |
|---|
| 意思決定 審査パイプライン | Decision Review Pipeline (DRP) | 技術的判断(ADR)を提出すると AI が網羅性・整合性・代替案検討を審査し、合格分だけを PR 化する関所。コードは drp/ | ADR-0019 |
| 起案 / 起案テキスト | draft / draft context | 起案者が KV (DRAFTS_KV) に投入する生テキスト。生成済み ADR 本文の再投入は禁止(起案者生テキスト形式) | operator_guide §4.3.1 |
| ゲート | gate | 起案を検査する関門。差戻し型(不合格で止める: Gate 0 / 受付プリゲート / 4 / Cross-Validation / 2)と情報提供型(止めずに指摘を PR へ付記: Gate 1 / 3 / Policy Alignment)の 2 種 | README §ゲート早見表 |
| 審査モード | triage mode | Gate 0 が決める審査の厳しさ 3 段階(Light / Standard / Critical)。Gate 4 の閾値(35/40/45)と起案テキストの必須節が変わる。L1〜L4(更新すべき文書層)とは直交 | ADR-0102 |
| 差戻し | rejection / send-back | ゲート不合格で PR 化せず起案者へフィードバックを返すこと。起案者は AI と壁打ちして自身で練り直す | 設計原則 |
| 起案前ゲート | pre-gate (triage gate) | Standard 以上の draft に必須節(コスト試算・撤退条件・Confirmation)を要求する投入前チェック。checkTriageGate でローカル検証可 | ADR-0088 / 0091 |
| 事後検証 | Retroactive Validation | 既に main 統合済の ADR を後から Pipeline に通しスコアと指摘のみ取得するフロー(PR は作らない) | README §9.2 |
2. ゲート・ノード
| 用語 (JA) | 用語 (EN) | 定義 | 関連 |
|---|
| トリアージ | Triage (Gate 0) | ADR に残す価値があるかの判定 + 審査モード決定。不要なら終了 | ADR-0030 |
| 受付プリゲート / 問題空間切り分け | problem-space pregate (problem_space_pregate / Gate 0a) | triage 通過直後・Gate 1 の前に走る分析破れの検査。起案を主張グラフ(問い/案/論拠)に分解し「塊の混在(独立した複数決定の詰め込み)・対症療法・行き先のない前提」を 2 段判定(一次=属性分岐シグナル抽出 / 二次=構造化分解+決定論的ルール)で検出。差戻し型・本文生成より前。FAIL は判定理由+逐語引用つき。graph 分岐で OFF 可能。本番稼働 2026-06-15 | ADR-0142 / 構造正典 §D-3 |
| 盲点検出 | blind-spot detection (Gate 1) | 起案者が見落としている論点の検出。DA + PM 並列 → Judge の DAG。差戻しなし | ADR-0071 |
| DA / PM / Judge | Devil's Advocate / Pre-mortem / Judge | Gate 1 の 3 役。DA(T=0.95)= 反対尋問役、PM(T=0.8)= 失敗を先回り想像する役、Judge(T=0.2)= 両者の指摘を集約する審判 | ADR-0071 |
| 本文生成 | body generation | 起案テキストを canonical ADR 構造(§1.1〜§7)に正規変換するノード | adr-draft.template.md |
| 採点 | Scoring (Gate 4) | 50 点満点の品質採点。モード別閾値未満は差戻し。N=5 Self-Consistency(5 回並列採点 → 多数決) | ADR-0056 |
| 整合検証 | Cross-Validation (CV) | Gate 1 の盲点が Gate 4 採点の Must 軸前提を毀損していないかの検証。毀損 = 差戻し | ADR-0076 / 0092 |
| 毀損 | undermines | CV の判定語。盲点 finding が Must 軸スコアの前提を崩すこと | ADR-0076 |
| 過去整合性 | Consistency (Gate 2) | 既存 ADR 全件との矛盾(Conflict)/ 上書き(Supersede)判定。supersede 宣言なき Conflict は差戻し | README §フェーズ計画 |
| 並列レビュー | parallel review (Gate 3) | Gemini Pro + Claude Opus + GPT o3 の 3 社複眼レビュー。差戻しなし・PR に追記 | ADR-0033 |
| 方針整合 | Policy Alignment | 会社固有方針との整合評価ノード。差戻しなし | — |
| 採番 / スラグ | numbering / slug | 次の ADR-NNNN を GitHub API で排他採番し、タイトルから snake_case slug を生成する終端ノード群 | — |
3. ループ制御・終端(ADR-0109 系)
| 用語 (JA) | 用語 (EN) | 定義 | 関連 |
|---|
| ゴールポスト移動 | goalpost (moving) | CV 差戻しのたびに指摘される盲点が毎回入れ替わる非決定パターン。同一原稿でも収束しない過剰審査の兆候 | ADR-0109 |
| 上限付きラウンド | bounded rounds / round-cap | CV の連続却下に上限(CROSSVAL_ROUND_CAP 既定 3)を設け停止性を保証する仕組み | ADR-0109 |
| エスカレート | escalate | goalpost / round-cap 検知時に自動 reject せず rejected=false で PR を起票し人間判断へ委ねる終端。merge=受理 / close=却下 | ADR-0109 |
| 残余リスク節 | Escalated Residual Risks | escalate 時に ADR 本文へ付与される「Known Limitations」節(HITL マーカー <!-- HITL-RATIFIED-RESIDUAL --> 付き) | ADR-0109 |
| 持続却下 | legit-persistent rejection | 同一盲点が一貫して却下され続けるケース。round-cap より優先して reject を温存(FN=0 維持) | ADR-0109 |
4. 基盤・運用
| 用語 (JA) | 用語 (EN) | 定義 | 関連 |
|---|
| ゲートウェイ | LiteLLM Gateway | GCP Cloud Run 上の multi-provider LLM 中継。全 LLM 呼出はここ経由 | README §アーキテクチャ |
| 機密マスキング | masking | LLM 送信前に取引先名・金額・scriptId・OAuth を除去する callback(fail-fast) | litellm/masking.py |
| 非同期実行 | async mode | Cloudflare 524 timeout (100s) 回避のため Queues + Durable Objects で残ゲートを非同期実行し polling で進捗取得する構成 | ADR-0066 |
| プロンプト SSoT | production prompt SSoT | プロンプト本文の正典 = prompts/production/<gate-id>/prompt.md(例外: gate3 は inline 構築)。転写コピー(test-tc*.mjs)の引用禁止 | ADR-0042 / 0085 |
| ゴールデン評価 | golden eval | 正解付きデータセット(golden.jsonl)による回帰評価。triage は FN=0 がブロッキングゲート | ADR-0102 |
| FN=0 ゲート | zero-false-negative gate | 「ADR に残すべき起案を誤って捨てる」偽陰性をゼロに保つブロッキング基準 | ADR-0102 |
| テレメトリ | telemetry | D1 telemetry_records への実行記録(schema v8 現行)。per-gate 所要時間・CV verdicts・escalate 観測など | ADR-0077〜0109 |
5. ドキュメント体系(ADR-0117 で導入)
| 用語 (JA) | 用語 (EN) | 定義 | 関連 |
|---|
| 層別ドキュメント体系 | layered docs / tiered docs | DRP 説明書を 9 層カタログ + 8 種 ID + L1〜L4 分類で再編した体系。本ディレクトリ(layers/)が実体 | ADR-0117 |
| L1〜L4 変更影響分類 | L1–L4 change impact classification | 改修が「どの文書層まで影響するか」の事前判定枠組み。正典は ID 規約 §3 | ADR-0117 |
| カバーズ | Covers | 下層 → 上層の一方向参照(SR が BR を充足する等)。frontmatter 限定で記載 | ADR-0117 |
| 制約 | Constrains | ADR → 下層要素への一方向参照(この決定が SR/EDD を拘束する) | ADR-0117 |
| 検証参照 | Verified-by | 対象 → テスト(TC-)への参照 | ADR-0117 |
| 孤児 ID | orphan ID | 参照先が未定義の ID。CI lint の検出対象 | ADR-0117 |
| トレーサビリティマトリクス | traceability matrix | 要求 ↔ 設計 ↔ テストの対応一覧。手書き・コミット禁止、CI 生成のみ | ADR-0117 |
| マトリクス腐敗 | matrix rot | 手書きマトリクスが実態から乖離していく最頻失敗モード。CI 生成で構造的に回避 | RQ-095 |
| ストラングラー・フィグ | strangler-fig | 旧 README から少しずつ抽出し同一コミットで旧本文を削除・リンク化する段階移行パターン(新旧併存 = drift の最頻原因) | RQ-095 |
| 形骸化 | hollowing-out / cargo-cult compliance | lint green のまま意味のない Covers 参照が増殖する状態。四半期サンプリング監査で検知 | ADR-0117 §1.4 |
変更履歴
| 日時 | 変更 |
|---|
| 2026-06-16 | ② 受付プリゲート(ADR-0142・Gate 0a)を §1「ゲート」差戻し型一覧と §2 ゲート・ノードに追加(本番稼働 2026-06-15 反映) |
| 2026-06-04 | 初版(ADR-0117 Phase 1) |