役割: DRP ドキュメント体系の全体索引。9 層 × 41 文書のカタログ定義(RQ-095 synthesis §5 が正典)に対し、現時点の実体ファイルと移行状態を対応付ける。
読者: 必要な層のファイルだけを読み込みたいエージェント / 改修の影響範囲を辿りたい人間。
更新: strangler-fig 移行(Phase 1〜3 / ADR-0117 §決定 6)の進行に合わせて本表を更新する。半年毎に棚卸し。
初見の読者の導線(Jr オンボーディング標準パス)
初見の人間・エージェントセッションは次の順で読む(読解所要 0.5〜1.0 人日):
- DRP 用語集 — 固有用語の JA↔EN
- ID 規約と L1〜L4 変更影響分類 — ID 8 種・参照規約・改修影響の判定法
- 本書(9 層カタログ索引)— どの情報がどの層・どのファイルにあるか
- README(ナビハブ) — 全体像と運用情報
凡例
| 状態 | 意味 |
|---|
| ✅ | 実体ファイルあり(リンク先が正典) |
| 🔜 P2 / 🔜 P3 | Phase 2 / Phase 3 で新設・移行予定 |
| ↪ 既存 | 既存資産がそのまま正典(再配置不要) |
0. 入口・概要層
| 文書 | 優先度 | 状態 | 実体 |
|---|
| README(ナビハブ・最終 ≤150 行) | Must | ✅ 縮退中 | README.md(Phase 1 で §目的/§設計原則/§ゲート表を抽出済・Phase 3 で ≤150 行へ) |
| 基本情報 + エレベーターピッチ | Must | ↪ 既存 | README 冒頭(ADR-0114 冒頭規約準拠) |
| 用語集(JA↔EN) | Must | ✅ | glossary.md(全体用語集 docs/architecture/glossary.md と棲み分け) |
| ID 規約 + L1〜L4 分類ガイド | Must | ✅ | id_conventions.md |
| 文書カタログ(本書) | Must | ✅ | document_catalog.md |
1. ビジネス要求層(BR-)
| 文書 | 優先度 | 状態 | 実体 |
|---|
| ビジネス要求定義書 | Must | ✅ | business_requirements.md(旧 README §3〜4 から抽出) |
| 対象ユーザー・ステークホルダー定義 | Must | ✅ | 同上 §3(Phase 2 で分冊要否を再判定) |
| 設計原則 | Must | ✅ | 同上 §4(旧 README §5 から抽出) |
| ビジネスフロー図 | Should | 🔜 P2 | 旧 README §6 を図化予定 |
2. システム要件層(SR- / NFR- / UC-)
3. 外部設計層(EDD-)
| 文書 | 優先度 | 状態 | 実体 |
|---|
| API 仕様書 + OpenAPI 定義 | Must | ✅ | api_specification.md(EDD-001。HTTP 18 ルート + Queue consumer)+ openapi.yaml(唯一の機械可読定義・整合指標①の突合対象) |
| データ定義書(D1・DO キー・queue 封筒) | Must | ✅ | data_definitions.md(EDD-002。telemetry v1〜v8 / KV / DO / 封筒。旧 README §12.5-12.6 から抽出) |
| プロンプト仕様書(ゲート別 I/O 契約) | Must | ✅ | prompt_io_contracts.md(EDD-003。SSoT 3 層経路 + 全ゲート I/O 契約・整合指標②の突合対象。prompts/0X_*.md は設計背景 doc として存続) |
| 状態遷移仕様 | Must | ✅ | state_machine.md(EDD-004。旧 README §8.1 図 3 から移設。移設先判断の記録: 状態機械は外部契約の正典のため、図のビュー層集約原則の例外として本層が原図を持ち、第 5 層・README からは参照のみ) |
| エラーモデル・コード表 | Should | 🔜 P2 | README §本番運用情報 のエラーハンドリング節から(HTTP エラーコード表は api_specification.md §2 に集約済) |
| 画面設計書(Web UI) | Should | 🔜 P2 | ADR-0111 e2e 文書と接続 |
| 外部 I/F 一覧 | Should | ✅ | external_interfaces.md(EDD-005。構成要素マッピング表 + コード実査から正典化) |
| CRUD マトリクス | Nice | 🔜 P3 | — |
4. 内部設計層(IDD-)
| 文書 | 優先度 | 状態 | 実体 |
|---|
| ゲート内部設計書(ノード別) | Must | ↪ 既存→🔜 P3 | nodes/01〜10 がほぼ移行可能 |
| キュー・DO 設計書 | Should | 🔜 P3 | ADR-0066/0103 実装記述を集約 |
| LiteLLM ルーティング設計書 | Should | 🔜 P3 | litellm/ + README §アーキテクチャ |
| リトライ・バックオフ設計書 | Nice | 🔜 P3 | DLQ / max_retries 記述から |
5. アーキテクチャビュー層(arc42 / C4 — 図はここに集約・各層から参照のみ)
| 文書 | 優先度 | 状態 | 実体 |
|---|
| システムコンテキスト図(C4 L1) | Must | 🔜 P2 | README §アーキテクチャ 図 1 の上位を分離 |
| コンテナ図(C4 L2) | Must | ↪ 既存 | README §アーキテクチャ 図 1(mermaid) |
| コンポーネント図(C4 L3) | Should | ↪ 既存 | README §アーキテクチャ ASCII 詳細図 |
| シーケンス図 | Must | ↪ 既存 | README §アーキテクチャ 図 2(mermaid) |
| デプロイ・CI/CD 構成図 | Should | 🔜 P2 | git_workflow + README から |
| 横断的関心事(ログ・シークレット・認証) | Should | 🔜 P2 | ADR-0104/0110 と接続 |
| ランタイムウォークスルー | Nice | 🔜 P3 | README §起案するとどうなるか の技術版 |
6. 決定層(ADR-)
| 文書 | 優先度 | 状態 | 実体 |
|---|
| ADR 本体(Covers:/Constrains: 追加) | Must | ✅ | docs/adr/(テンプレートに Covers/Constrains フィールド追加済。既存 110+ 本は不変・Phase 3 で被参照上位 20 本に後付け) |
| ADR インデックス(自動生成) | Should | 🔜 | MAS-367/368 計画に合流(重複起案しない) |
7. 検証層(TC-)
| 文書 | 優先度 | 状態 | 実体 |
|---|
| テスト計画書(層×テスト種別の戦略) | Should | ✅ | test_plan.md(L1〜L4 × テスト層・FN=0 ブロッキング方針・整合指標 CI 化の main 申し送り) |
| テスト設計書(層別) | Should | ✅ | test_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 | 🔜 P2 | operator_guide §7.x 群を分離 |
| 監視・テレメトリ仕様 | Should | 🔜 P2 | D1 スキーマ自体は データ定義書 が正典化済。残 = 監視・アラート運用の仕様化 |
| 変更履歴 | Must | ↪ 既存 | changelog.md + git history |
Phase 別移行状態(ADR-0117 §決定 6)
| Phase | 内容 | 状態 |
|---|
| Phase 1 | must-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-05 | Phase 2 主要 7 文書の状態列を ✅ 化(EDD-001〜004 / NFR / テスト計画・設計)。状態遷移仕様の移設先判断(第 3 層が原図を持つ例外)を記録(ADR-0117 Phase 2) |
| 2026-06-05 | 外部 I/F 一覧(EDD-005)を ✅ 化 — Phase 2 Should 群の先行 1 本 |