意思決定 審査パイプライン DRP の運用・仕様・実装記録の入口ページ。 「どこに何があるか」で迷ったら最初にここを見る。

§1 このディレクトリは何か

docs/_internal/03_decisions/ は DRP の運用ドキュメントを集めた場所。 DRP の実装コードは drp/ にある。 本ディレクトリは実装ではなく、パイプラインの設計・プロンプト・ノード解説・運用手順・過去レビューを扱う。

物理レイヤは ADR-0045 の _internal/03_decisions/ の細分。 nav 上の namespace は I.03 で、下位 group I.03.0I.03.7 を持つ。

§2 まず読むもの(初見の導線)

初見のエージェント・人間はこの順で読む。 所要は 0.5〜1.0 人日を目安にする。

  1. DRP 用語集 — 固有用語の JA↔EN と定義
  2. ID 規約と L1〜L4 変更影響分類 — ID 8 種・参照規約・改修時の判定法
  3. 9 層カタログ — どの層のどのファイルに何があるか
  4. パイプライン README — 全体像とゲート早見表

§3 サブディレクトリ束

I.03 は下位 8 グループに分かれる。 役割と入口は次のとおり。

namespace扱う内容入口
I.03.0 全体像9 層カタログ・用語集・ID 規約・README9 層カタログ
I.03.1 本ページドキュメント入口・マッピング(本ページ)
I.03.2 運用ガイド手順書・LangGraph 移行チェックリストoperator_guide_langgraph
I.03.3 ノード詳細各ノードの人間向け解説 24 本判定ルール俯瞰
I.03.4 プロンプト群各ゲートのプロンプト設計 15 本Gate 0 Triage
I.03.5 実装・KV 投入Webhook 修正等の作業プロンプト(I.03.5 グループ)
I.03.6 過去 ADR レビューRetroactive Validation 結果ADR-0042 レビュー
I.03.7 adr-kit セットアップツール設定素材BizLink ドメイン素材
I.03.8 intake_chat起案者向け intake サイト仕様intake_chat README

nav の group 順序は docs/_config.jsoninternal.03.* 群で決まる。番号の並びは group 名の順で、本表とは 1 段ずれる場合がある(本ページを追加した 2026-07-01 以後、正しい nav 番号は左メニューを見る)。

§4 マッピング図(層別配置)

DRP ドキュメント全体の配置マップ。 9 層カタログを軸に、サブディレクトリと参照方向を 1 枚で見せる。

DRP docs mapping

図の見方:

  • 色分け = 9 層 L0〜L8
  • 実線 = SSoT 参照(Covers / Verified-by)
  • 点線 = 関連参照(読者導線・棲み分け説明)

図の大元は 9 層カタログ にある RQ-095 §5 の 41 文書カタログ。 参照規約は ID 規約 §2

§5 探し方(質問 → 参照先)

よくある疑問と参照先の対応表。 迷ったら該当セルのリンクから読み始める。

疑問参照先
全体像・ゲート早見表は?パイプライン README
用語の意味は?DRP 用語集
ID 採番のルールは?ID 規約 §1
改修時にどの層まで影響?ID 規約 §L1〜L4 分類
ノードの動作は?ノード詳細プロンプト設計
プロンプト SSoT の場所は?ファイルマニフェストプロンプト I/O 契約
起案者向け壁打ちは?intake_chat README
過去 ADR の Retroactive Validation は?I.03.6 グループ
Dify から LangGraph への移行記録は?migration_overview
MVP 卒業条件は?MVP exit 基準
関連 ADR は?本ページ §7

§6 現状の抜け・重複メモ(Living)

半年毎の棚卸しで更新する。 各項目は初診段階として「候補」ラベル、確定・却下は棚卸し時に確定させる。

§6.1 抜け候補(2026-07-01 Explore 初診)

  • 障害対応・ロールバック手順のフロー — MVP exit 基準はあるが、本番で Gate が壊れた際の対応フロー文書がない
  • prompt fitness function / evaluation metric の統合索引 — ADR-0138 / ADR-0142 の実体を DRP 側から辿る入口がない
  • ADR 逆辺索引 — 「この Gate が依存する上位 ADR は何か」を逆向き検索できない(theoretical_foundations は cross-ref があるが逆索引ではない)
  • 「初めてのノード追加」step-by-step チェックリスト — nodes/ の解説はあるが、新ノード追加時の作業順が散在
  • マルチテナント setup guide — Policy Alignment ノードの解説はあるが、新テナント追加時の設定手順がない

§6.2 重複候補(2026-07-01 Explore 初診)

  • prompts/01_triage.mdnodes/01_triage.md の棲み分け説明が入口に欠落 — prompts=プロンプト設計 / nodes=ノード動作の区分だが、読者が最初に読むページの案内がない
  • Gate 1 sub-nodes(DA / Judge / PM)が prompts/13〜15 と nodes/21〜23 で 2 重解説 — 差分の明確化が欲しい
  • SSoT 不明: decision_jtbd_candidates.md01_discovery/customer_insight/_builder_jtbd_list.md — どちらが SSoT かの明記がない

§6.3 参照しにくい候補(2026-07-01 Explore 初診)

  • theoretical_foundations — ファイルパスが深く、ADR 参照の重要性から見て docs/adr/ 直下からも辿れる索引があるべき
  • 孤立 operator-prompt 27 ファイル — nav 未登録で全文検索でしか参照できないが、性格上「1 回限りの作業プロンプト」なので現状の運用は妥当
  • layers/00_entry/id_conventions.md から document_catalog.md への導線は明快だが、「新規ノード追加時の step-by-step」チェックリストが欲しい(§6.1 と重複)

§7 関連 ADR

§8 関連ページ(横断)

§9 更新ルール

本ページは Living Document として運用する。

  • §6 抜け・重複メモ: 半年毎の棚卸しで確定・却下を判定。初診の追加は随時
  • §4 マッピング図: 9 層カタログ(RQ-095 §5)の更新に追従。_diagrams/i-03-map.d2 を編集して SVG 再生成
  • §3 サブディレクトリ束: _config.jsoninternal.03.* group が増減したら更新

半年毎の棚卸しは docs/_internal/06_ops/ の棚卸し issue で回す。