役割: DRP ドキュメント体系の全体索引。9 層 × 41 文書のカタログ定義(RQ-095 synthesis §5 が正典)に対し、現時点の実体ファイルと移行状態を対応付ける。 読者: 必要な層のファイルだけを読み込みたいエージェント / 改修の影響範囲を辿りたい人間。 更新: strangler-fig 移行(Phase 1〜3 / ADR-0117 §決定 6)の進行に合わせて本表を更新する。半年毎に棚卸し。

初見の読者の導線(Jr オンボーディング標準パス)

初見の人間・エージェントセッションは次の順で読む(読解所要 0.5〜1.0 人日):

  1. DRP 用語集 — 固有用語の JA↔EN
  2. ID 規約と L1〜L4 変更影響分類 — ID 8 種・参照規約・改修影響の判定法
  3. 本書(9 層カタログ索引)— どの情報がどの層・どのファイルにあるか
  4. README(ナビハブ) — 全体像と運用情報

凡例

状態意味
実体ファイルあり(リンク先が正典)
🔜 P2 / 🔜 P3Phase 2 / Phase 3 で新設・移行予定
↪ 既存既存資産がそのまま正典(再配置不要)

0. 入口・概要層

文書優先度状態実体
README(ナビハブ・最終 ≤150 行)Must✅ 縮退中README.md(Phase 1 で §目的/§設計原則/§ゲート表を抽出済・Phase 3 で ≤150 行へ)
基本情報 + エレベーターピッチMust↪ 既存README 冒頭(ADR-0114 冒頭規約準拠)
用語集(JA↔EN)Mustglossary.md(全体用語集 docs/architecture/glossary.md と棲み分け)
ID 規約 + L1〜L4 分類ガイドMustid_conventions.md
文書カタログ(本書)Mustdocument_catalog.md

1. ビジネス要求層(BR-

文書優先度状態実体
ビジネス要求定義書Mustbusiness_requirements.md(旧 README §3〜4 から抽出)
対象ユーザー・ステークホルダー定義Must同上 §3(Phase 2 で分冊要否を再判定)
設計原則Must同上 §4(旧 README §5 から抽出)
ビジネスフロー図Should🔜 P2旧 README §6 を図化予定

2. システム要件層(SR- / NFR- / UC-

文書優先度状態実体
システム要件定義書(ゲート別)Mustsystem_requirements.md(旧 README §7 ゲート早見表を正典化。verified-by 全 SR 割当済 2026-06-05)
非機能要件定義書Mustnonfunctional_requirements.md(NFR-001〜008。散在記述を集約・Phase 2)
ユースケース一覧Should🔜 P2UC-{N} 採番が既存

3. 外部設計層(EDD-

文書優先度状態実体
API 仕様書 + OpenAPI 定義Mustapi_specification.md(EDD-001。HTTP 18 ルート + Queue consumer)+ openapi.yaml(唯一の機械可読定義・整合指標①の突合対象)
データ定義書(D1・DO キー・queue 封筒)Mustdata_definitions.md(EDD-002。telemetry v1〜v8 / KV / DO / 封筒。旧 README §12.5-12.6 から抽出)
プロンプト仕様書(ゲート別 I/O 契約)Mustprompt_io_contracts.md(EDD-003。SSoT 3 層経路 + 全ゲート I/O 契約・整合指標②の突合対象。prompts/0X_*.md は設計背景 doc として存続)
状態遷移仕様Muststate_machine.md(EDD-004。旧 README §8.1 図 3 から移設。移設先判断の記録: 状態機械は外部契約の正典のため、図のビュー層集約原則の例外として本層が原図を持ち、第 5 層・README からは参照のみ)
エラーモデル・コード表Should🔜 P2README §本番運用情報 のエラーハンドリング節から(HTTP エラーコード表は api_specification.md §2 に集約済)
画面設計書(Web UI)Should🔜 P2ADR-0111 e2e 文書と接続
外部 I/F 一覧Shouldexternal_interfaces.md(EDD-005。構成要素マッピング表 + コード実査から正典化)
CRUD マトリクスNice🔜 P3

4. 内部設計層(IDD-

文書優先度状態実体
ゲート内部設計書(ノード別)Must↪ 既存→🔜 P3nodes/01〜10 がほぼ移行可能
キュー・DO 設計書Should🔜 P3ADR-0066/0103 実装記述を集約
LiteLLM ルーティング設計書Should🔜 P3litellm/ + README §アーキテクチャ
リトライ・バックオフ設計書Nice🔜 P3DLQ / max_retries 記述から

5. アーキテクチャビュー層(arc42 / C4 — 図はここに集約・各層から参照のみ)

文書優先度状態実体
システムコンテキスト図(C4 L1)Must🔜 P2README §アーキテクチャ 図 1 の上位を分離
コンテナ図(C4 L2)Must↪ 既存README §アーキテクチャ 図 1(mermaid)
コンポーネント図(C4 L3)Should↪ 既存README §アーキテクチャ ASCII 詳細図
シーケンス図Must↪ 既存README §アーキテクチャ 図 2(mermaid)
デプロイ・CI/CD 構成図Should🔜 P2git_workflow + README から
横断的関心事(ログ・シークレット・認証)Should🔜 P2ADR-0104/0110 と接続
ランタイムウォークスルーNice🔜 P3README §起案するとどうなるか の技術版

6. 決定層(ADR-

文書優先度状態実体
ADR 本体(Covers:/Constrains: 追加)Mustdocs/adr/(テンプレートに Covers/Constrains フィールド追加済。既存 110+ 本は不変・Phase 3 で被参照上位 20 本に後付け)
ADR インデックス(自動生成)Should🔜MAS-367/368 計画に合流(重複起案しない)

7. 検証層(TC-

文書優先度状態実体
テスト計画書(層×テスト種別の戦略)Shouldtest_plan.md(L1〜L4 × テスト層・FN=0 ブロッキング方針・整合指標 CI 化の main 申し送り)
テスト設計書(層別)Shouldtest_design.md(TC-U / TC-G / TC-E / TC-MK 系列を採番。既存 TC-01〜07 / S / C 系の定義場所は test_cases.md のまま)
golden データセット仕様Should↪ 既存prompts-eval/datasets/*/golden.jsonl + tools/triage-eval
トレーサビリティマトリクス(CI 生成・コミット禁止)Must🔜 P1(main)CI lint と同時に main が実装

8. 品質・リスク・運用層

文書優先度状態実体
品質シナリオ(arc42 §10)Nice🔜 P3
リスク・技術的負債台帳(arc42 §11)Should↪ 既存BUG_tracking + failure_patterns.md が実質
運用ガイドMust↪ 既存operator_guide_langgraph.md
ランブック(障害対応)Should🔜 P2operator_guide §7.x 群を分離
監視・テレメトリ仕様Should🔜 P2D1 スキーマ自体は データ定義書 が正典化済。残 = 監視・アラート運用の仕様化
変更履歴Must↪ 既存changelog.md + git history

Phase 別移行状態(ADR-0117 §決定 6)

Phase内容状態
Phase 1must-have 8 項目(用語集 / ID 規約 / BR≥3 / ゲート別 SR / ADR テンプレ Covers / README ハブ化 = sub、CI lint / PR テンプレ L1-L4 = main)sub 分 6 項目 実施済(2026-06-04)・main 分 2 項目 未着手
Phase 2外部設計 4 分冊 + OpenAPI + テスト計画主要 7 文書 実施済(2026-06-05): 外部設計 4 分冊(EDD-001〜004)+ openapi.yaml + NFR 定義書 + テスト計画/設計書(verified-by 全 SR 割当済)。整合指標 2 件の CI 化は main 申し送り。Should 優先度の残り 🔜 P2 行(ビジネスフロー図 / UC 一覧 / エラーモデル / 画面設計 / C4 L1 / デプロイ図 / 横断的関心事 / ランブック / 監視運用)は未着手。外部 I/F 一覧(EDD-005)は 2026-06-05 に先行実施済
Phase 3内部設計移行 + 被参照上位 20 ADR への Covers 後付け未着手

変更履歴

日時変更
2026-06-04初版(ADR-0117 Phase 1)
2026-06-05Phase 2 主要 7 文書の状態列を ✅ 化(EDD-001〜004 / NFR / テスト計画・設計)。状態遷移仕様の移設先判断(第 3 層が原図を持つ例外)を記録(ADR-0117 Phase 2)
2026-06-05外部 I/F 一覧(EDD-005)を ✅ 化 — Phase 2 Should 群の先行 1 本