I.03.1 意思決定パイプライン ドキュメント入口
意思決定 審査パイプライン DRP の運用・仕様・実装記録の入口ページ。 「どこに何があるか」で迷ったら最初にここを見る。
§1 このディレクトリは何か
docs/_internal/03_decisions/ は DRP の運用ドキュメントを集めた場所。
DRP の実装コードは drp/ にある。
本ディレクトリは実装ではなく、パイプラインの設計・プロンプト・ノード解説・運用手順・過去レビューを扱う。
物理レイヤは ADR-0045 の _internal/03_decisions/ の細分。
nav 上の namespace は I.03 で、下位 group I.03.0〜I.03.7 を持つ。
§2 まず読むもの(初見の導線)
初見のエージェント・人間はこの順で読む。 所要は 0.5〜1.0 人日を目安にする。
- DRP 用語集 — 固有用語の JA↔EN と定義
- ID 規約と L1〜L4 変更影響分類 — ID 8 種・参照規約・改修時の判定法
- 9 層カタログ — どの層のどのファイルに何があるか
- パイプライン README — 全体像とゲート早見表
§3 サブディレクトリ束
I.03 は下位 8 グループに分かれる。 役割と入口は次のとおり。
| namespace | 扱う内容 | 入口 |
|---|---|---|
| I.03.0 全体像 | 9 層カタログ・用語集・ID 規約・README | 9 層カタログ |
| 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.jsonのinternal.03.*群で決まる。番号の並びは group 名の順で、本表とは 1 段ずれる場合がある(本ページを追加した 2026-07-01 以後、正しい nav 番号は左メニューを見る)。
§4 マッピング図(層別配置)
DRP ドキュメント全体の配置マップ。 9 層カタログを軸に、サブディレクトリと参照方向を 1 枚で見せる。
図の見方:
- 色分け = 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.mdとnodes/01_triage.mdの棲み分け説明が入口に欠落 — prompts=プロンプト設計 / nodes=ノード動作の区分だが、読者が最初に読むページの案内がない- Gate 1 sub-nodes(DA / Judge / PM)が prompts/13〜15 と nodes/21〜23 で 2 重解説 — 差分の明確化が欲しい
- SSoT 不明:
decision_jtbd_candidates.mdと01_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
- ADR-0117 DRP 層別再編 — 本体系の根拠(9 層カタログ・8 種 ID・L1〜L4 分類)
- ADR-0114 概要ページ冒頭規約 — landing の書式規約
- ADR-0045
_internal文書管理ポリシー —_internal/03_decisions/の位置付け - ADR-0071 Gate 1 盲点検出設計 — DA/PM/Judge の DAG 設計
- ADR-0102 審査モード Tier 化 — Light/Standard/Critical の閾値と必須節
- ADR-0155 Phase c GCP SM 認証 — DRP API 認証経路
- ADR-0164 intake サイト分離 — I.03.8 intake_chat の位置付け
§8 関連ページ(横断)
- 分類軸マップ — namespace / _internal レイヤ / 事業軸の関係
- 全ドキュメント目次 — サイト全体の flat 目次
- ADR README — ADR 制度・命名規則・起案フロー
- handover プロンプト一覧 — 運用プロンプト受信箱
§9 更新ルール
本ページは Living Document として運用する。
- §6 抜け・重複メモ: 半年毎の棚卸しで確定・却下を判定。初診の追加は随時
- §4 マッピング図: 9 層カタログ(RQ-095 §5)の更新に追従。
_diagrams/i-03-map.d2を編集して SVG 再生成 - §3 サブディレクトリ束:
_config.jsonのinternal.03.*group が増減したら更新
半年毎の棚卸しは docs/_internal/06_ops/ の棚卸し issue で回す。