最終更新: 2026/06/22 18:56
索引・目次・カタログ棚卸しリスト (ADR-0130)
自動生成:
node scripts/doc-inventory.mjsが docs 配下を走査して生成する。手で編集しない (CI が drift を検出する)。 振り分けの変更はscripts/doc-inventory.mjsのレジストリ (GENERATORS / TICKETS / EXCEPTIONS) を編集して再生成・コミットする。 規律の正典: ADR-0130 (受理 2026-06-10 / 既存ページの振り分け期限 = 受理 6 ヶ月後の判定タイミング)
走査範囲 (in-scope / out-of-scope)
- in-scope:
docs/**/*.mdのうちファイル名が*-index.md / *_index.md / index.md / *-catalog.md / *_catalog.md / *-list.md / *_list.md / *-toc.md / toc.md(大文字小文字不問) に一致するもの + セクション単位の手動登録 (EXTRA_TARGETS) - out-of-scope (意図的除外):
tasks/(Confirmation 6 の個別 ADR で扱いを決定) /tmp/・_archive/(作業スクラッチ・退役済み) / コードドメインdrp/ mas/ ocr/ webapp_client/等 (対象パターンの実在ファイルゼロ。新設時は走査範囲拡張を検討) / GAS コード由来の一覧 (タブ一覧・列マッピング等 — code→docs codegen の是非は DOC-OPS-25 で別判断・詳細は #1693 申し送りtasks/prompts/main_2026-06-10_doc-inventory-section-list-candidates.md群B) / legacy-dev 配下の案件ドキュ内チェックリスト (完了後凍結の履歴) - 既知の限界: ファイル名パターンの構文的検査のため、
summary.md等への偽装・既存ページへの一覧セクション追記は検知できない。レビュー観点 (ADR-0130 Confirmation 5) で補完する
サマリ
- 対象: 22 件
- 内訳: 生成器化済み 9 / 案件起票済み 0 / 例外指定 13 / 未振り分け 0
✅ 生成器化済み (9)
3 点セット (生成器 + CI --check + 走査範囲明文化) を満たす。
| ページ | タイトル | 生成器 / 行き先 / 理由 |
|---|---|---|
| docs/COVERAGE_GAPS.md | handover 残タスク一覧 | scripts/generate-coverage-gaps.mjs (docs ビルドで自動生成 / ADR-0145 で handover 残タスク一覧へ転用。元データ = tasks/prompts のマーカー節。旧 known-unknowns は TODO_future.md へ移送) |
| docs/_internal/06_ops/doc_changelog/index.md | ドキュメント変更履歴 | scripts/generate-doc-changelog.mjs (docs ビルドで自動生成) |
| docs/_internal/06_ops/doc_news/index.md | 最新更新ページ (What's New) | scripts/generate-doc-news.mjs (docs ビルドで自動生成) |
| docs/_internal/06_ops/index_catalog_inventory.md | 索引・目次・カタログ棚卸しリスト (ADR-0130) | scripts/doc-inventory.mjs (本リスト自身・CI: adr-lint.yml --check) |
| docs/_internal/06_ops/prompt_catalog.md | プロンプト・カタログ (索引 SSoT) | scripts/prompt-catalog.mjs (CI: adr-lint.yml --check) |
| docs/adr/INDEX.md | 既存 ADR 一覧 (自動生成索引) | scripts/adr-index.mjs (CI: adr-lint.yml --check / ADR-0107 適用 2 号: 全 ADR 一覧 + 関係図 + メタ欠落警告。元データ = adr-index.json・旧 README §15 手書き表はポインタ化) |
| docs/domains/README.md | domains/ — feature-folder（機能別現行仕様） | scripts/generate-domains-list.mjs (CI: adr-lint.yml --check / DOC-OPS-24 ①で §機能一覧 をセクション単位生成器化。機能名・legacy_id の SSoT は各ドメインの frontmatter) |
| docs/index.md | 全ドキュメント目次 — グループ俯瞰マップ | scripts/generate-docs-index.mjs (CI: adr-lint.yml --check / DOC-OPS-23 で生成器化完了) |
| docs/research/INDEX.md | 既存 RQ 一覧 (自動生成索引) | scripts/rq-index.mjs (CI: adr-lint.yml --check / ADR-0130 適用: 3 系統 (research/ + research_prompts/ + research_questions.md §3) の RQ 横断一覧。元データ = rq-index.json) |
⛔ 例外指定 (13)
対象判定基準を満たさない (一覧自体が SoT・キュレーション本文など)。理由必須。
| ページ | タイトル | 生成器 / 行き先 / 理由 |
|---|---|---|
| docs/_internal/01_discovery/customer_insight/_builder_jtbd_list.md | 承認済み JTBD 一覧 — ビルダー/Decision Pipeline プロダクト (SSoT) | 一覧自体が SoT (JTBD 定義の原本。他所から機械生成不能) |
| docs/_internal/01_discovery/customer_insight/_construction_jtbd_list.md | 建設業界 JTBD 整理 — 参照セグメント（OmniClass ベース・ベンチ） | 一覧自体が SoT (JTBD 定義の原本。他所から機械生成不能) |
| docs/_internal/01_discovery/customer_insight/_jtbd_list.md | 承認済み JTBD 一覧 (SSoT) | 一覧自体が SoT (JTBD 定義の原本。他所から機械生成不能) |
| docs/_internal/01_discovery/ref_boutique_fpa_investment_catalog.md | 軽量FP&Aのための投資カタログ完全設計書 | 調査・設計本文 (type: research / RQ-070)。文書索引ではなくファイル名に catalog を含むだけ。判定基準の対象外 |
| docs/_internal/03_decisions/decision_pipeline/layers/00_entry/document_catalog.md | DRP 文書カタログ（9 層・層別索引） | ハイブリッド: 9 層×41 文書のカタログ定義の正典は RQ-095 synthesis、移行状態 (🔜 P2 / ↪ 既存) は人間判断を含む追跡情報。実体ファイル有無のリンク検証のみ機械化余地あり |
| docs/_nav/traceability.md | 要件→仕様→ADR→テスト トレーサビリティマップ | §旧仕様対応表 = 移行履歴の原本 (凍結)。トレーサビリティ表本体は ADR-0107 系の将来検討 |
| docs/adr/0162-formalize-impl-detail-and-implement-adr-lint-adr-index.md | ADR メタデータ (ADR-0137 Phase 1: 本文太字メタ欄から複製。Phase 2 で本文側を削除し原本化) | ADR 本文 (impl_detail 正式化 = ADR-0162)。ADR-0130 §1.4「ADR 本文・設計書・手順書は対象外」に該当 (ファイル名末尾の "-adr-index" は実装対象スクリプト名の一部であり文書索引ではない) |
| docs/architecture/erp_reference_index.md | ERP リファレンス索引（MAS） | ハイブリッド: リンク表は frontmatter から導出可能だが、文書階層 (PRD→FRD→TDD) の解説・対象読者・記述レベルが編集判断を含む原本情報 (旧 SUMMARY §2.7 から移設) |
| docs/architecture/spec_nfr.md | 33. 非機能要件 (NFR) | §NFR テーブル = 測定日・実測値付きの仕様スナップショット (履歴は git blame で追跡)。機械生成不能 |
| docs/architecture/spec_tab_renumber.md | タブナンバリング整理 | §変更一覧 = タブリナンバー履歴 (凍結済み)。履歴の原本 |
| docs/architecture/use_cases.md | ユースケース集: 経営判断シナリオ（UC-1〜UC-5） | §シナリオ一覧 = ビジネス要件の原本 (年次レビュー対象)。一覧自体が SoT |
| docs/data/data-definitions/data_def_index.md | データ定義書 — 索引 | ハイブリッド: §3 全タブ索引は機械生成可能だが §4 RENAME_MAP (列リネーム履歴の原本)・凡例・読み方が原本情報。セクション単位の生成器化は将来検討 |
| docs/implementation/legacy-dev/dev_mas-214_menu_catalog.md | MAS-214: 自動生成型メニューカタログタブ (00_menu) | 開発仕様書本文 (MAS-214)。ADR-0130 §1.4「ADR 本文・設計書・手順書は対象外」に該当 (GAS メニューカタログ機能の仕様であり文書索引ではない) |