engine epic folio-0dv は folio の文書規律を一般化した汎用文書生成エンジンを構築する (engine 設計 doc)。 その sub-epic folio-c5r は「任意プロジェクト向けの完全な文書一式」(canonical 約 17 doc-type) を被覆する roadmap である。 engine が現在生成できる 5 doc-type (SRS / ADR / research / principle / spec=rules) はいずれも要件索引型 — 要件・主張・原則を id で索引し、 EARS 章立てや RTM 三層連結で振る舞いを記述する文書型である。
gap — 記述型 doc-type が engine に欠けている。 多エージェント監査 (doctype-coverage-audit・wf_8e16a043) は、 汎用 suite を構成する約 17 doc-type のうち engine が生成できるのは 5 種のみで、 architecture-description が最も paradigm-breaking な穴 (P1) と確定した。 記述型は要件索引型を脱す — EARS も RTM も乗らず (構造を描く文書であって振る舞いを索引しない)、 floor が薄く ceiling 主導になりがちで、 機械保証の強度が落ちるのが最大の不確実点だった。
framing — architecture-description は「構造の WHAT」であって「HOW」でない。 constitution P-7 は design intent (WHAT) を構造・不変条件と既に規定する。 SRS = 振る舞いの WHAT / architecture = 構造の WHAT (両方とも design-intent の内側) であり、 実装 HOW (コード / SQL / ライブラリ / platform 固有) のみが外側 (P-3 / P-11)。 当初の「構造 HOW」というラベルは廃語で、 constitution の改訂は不要 (既に self-consistent)。
記述型 pack 自体が engine 初の領域ゆえ、 設計 grill (2026-06-26) は reader 論点でなく demo-walk-first で進めた — 抽象論点だけでは非エンジニアが全体像を判断できないため、 opus でモックアップを生成し :8729 で walk し、 反応で論点を確定してから本物の決定的 pack を構築した (見た目 design system の S1–S4 と同型)。 walk は照会リンクの着地バグを炙り出し、 案A (別文書照会) の確定・照会 graph = floor 背骨の発見・生成 doc に navigable id アンカーが無い問題 (folio-lzz) を顕在化させた。 clinic 診療予約 architecture を母体 (instance#1) に本物 pack を構築・検証し、 本 ADR はその実装 + 検証 + land (main 503ccb5) 後の forward decision を記録する。
architecture-description pack は arc42 の固定章立て (課題と外部接点 / 全体戦略 / 構成部品 / 実行時の流れ / 設計決定 / 品質 / リスク / 用語の固定 8 章) と C4 の階層図 (mermaid で描く) を schema に採る。 固定章を採る load-bearing な理由は、 章の集合が floor の検査単位を与えること — 記述型でも「章の存在 + 各章の必須要素 (id 付き component / decision / quality / risk node) の存在」を機械検査でき、 EARS/RTM が乗らない記述型でも厚い floor を張る土台になる (§1 の最大不確実点への答え)。 図は ADR-0041 visual design system の render target (<pre class="mermaid">) として出し、 非エンジニア可読性 (gate I) を担保する。
architecture-description pack の floor は次の三本柱を持つ。
verify_cross_doc_refs + verify-graph.sh をそのまま流用する。 ★記述型の floor 背骨は EARS でなく照会 graph — cross-ref は文章でなく機械検査可能なグラフの辺であり、 これが記述型でも floor を厚くできる核心。加えて floor を次で補強する: 実装HOWリーク advisory 検出 (コード / platform mandate の本文混入を ADR-0043 の HOW-outside / P-11 4-enum 保守検出として横展開・core 無改変) / CJK inline 強調の空白規律 (assembler が強調タグの前後に空白を入れると助詞前で改行崩れを起こすため FAIL 検出・既知 CJK 語境界難所と同根) / fab-free (属性 pin と可視 echo pin の両方 = 属性が intact でも可視テキストだけ捏造する fail-open を塞ぐ)。
architecture-description は SRS の要件 / ADR の決定 / principle の原則へ cross-document link で照会するだけで再掲しない。 照会クリックで実際の別文書 (ADR / SRS / principle のページ) へ飛び、 architecture-description 自身は inline 要約も持たない。 これは WHAT → WHY → 構造の WHAT → 実装 HOW というはしご (SRS = 振る舞いの WHAT / ADR = WHY / architecture = 構造の WHAT / 実装 = HOW) の各段が互いを指すが再掲しない構造である。 inline 要約 (案B / 案C) は飛び先文書が既に持つ cover-summary / plain 説明と二重保持になり drift 源となるため採らない (§4)。
design-of-record (探索): doctype-coverage-audit (research domain・gap SSoT = architecture-description を P1 gap と確定・段階3 を定義) + engine 設計 §9.1 (doc-type → pack 写像仮説・self-spec を SRS 族と仮説したが tr0 grounding で記述型と覆った)。 基盤: ADR-0043 (照会 graph 終端完備検証 〔verify_cross_doc_refs + verify-graph.sh〕 を floor 背骨に流用・HOW-outside content boundary を実装HOWリーク advisory に横展開)・ADR-0041 (人間層 visual design system + 機械 SSoT 生成 + 2-gate 検証を記述型へ適用)・ADR-0042 (構造 = 決定的組立 / prose = opus 充填の hybrid 生成を記述型へ適用)。 継承: ADR-0044 (engine core 抽出完了の doctrine を記述型 pack の core 無改変で継続実証)。 原則接地: P-7 (3-domain・design intent = 構造の WHAT) / P-3 (WHAT/HOW 分離) / P-11 (HOW の隔離) / P-10 (ADR 昇格は user 承認)。 追跡: bd engine epic folio-0dv / sub-epic folio-c5r 段階3 folio-5uu (worker build 912a0a5・land main 503ccb5・contract YAML + assemble-arch.sh + rolemap + verify-arch.sh + prose manifest + test-adversarial-arch.sh の 6 ファイル)。 follow-up: folio-lzz (生成 doc が referenceable node に navigable id アンカーを出す・案A 前提・横断スコープ) / folio-bur (fab-free 可視 echo pin の他 pack 横展開) / folio-udn (arch gate-I polish = 照会バッジ外部リンク affordance + term-inline 併記非対称) / folio-7vd (architecture 専用 ceiling agent = persona-walk-architecture + fidelity-architecture)。 決定の経緯: user demo-walk grill 2026-06-26 (opus モックアップ → :8729 walk → 反応で論点確定。 walk が照会リンク着地バグを炙り出し案A確定 + 照会 graph = floor 背骨の発見 + navigable id 欠落 〔folio-lzz〕 を発見・粒度 OK 確認)。 検証: floor 全 GREEN を admin 独立再走 (assemble / verify pre-fill + filled PASS・敵対 57/57・verify-graph FLOOR-OK 〔ARCH-CLINIC-APPT 終端完備・PRIN-SAFETY-FIRST を ADR と共有〕・sandbox 41/41 回帰 0・core 〔lib/ + inject-prose.sh〕 diff 空 = 無改変・folio validate clean) + 独立 ceiling wf_58801326 (3 レンズ opus・fidelity minor1 = rationale-AD-1 の案A no-restate drift を prose 修正 e405e5b で除去 / persona gate I 実質達成 〔mermaid 3 図 SVG・mobile 崩れ無し〕 / 可視層 fabrication 敵対 74 攻撃 fail-open 0)。 version: 本 ADR 文書版 = 1.1.0 (記録する capability は engine epic folio-0dv・後方互換追加)。