maplisted

# map ## 目標 快速產出風格統一的架構圖，幫助理解內容——畫**關係與約束**，不是檔案清單。圖是迭代起點：看過後回饋調整重畫，或點名某塊深入、屆時才做細查。不逐項查證，但不畫沒有依據的線；找不到依據的內容進省略表，不用推測補滿圖。 ## 執行流程 1. **定義範圍**：無參數或要「大綱」→ 大綱頁；參數是業務功能名（如「核決」「請款」）→ 主題頁（兩者見「兩種標準產出」）；參數是路徑或技術子系統 → 聚焦該範圍的自由分析。不確定屬哪種就出選擇題：列出候選型態、各附一句預期產出，讓使用者挑，不問開放式問題。接著固定一句要回答的讀者問題，後續四表與 provider 不得自行改換視角。 2. **快速偵察**：讀相關的 `AGENTS.md`、`CLAUDE.md`、`README.md`，把其中的分層、資料邊界與禁止事項當骨架；再快掃 `import`、`require`、呼叫、讀寫與 `symlink` 補上實際關係。只展開必要檔案，不逐邊查證。 3. **產中介表示**：依 `references/intermediate-tables.md` 產四張表（節點、邊、群組、省略）；邊表的 `種類` 為必填。四表只寫語意、不夾帶圖面決策。節點數**預設壓到 9 以內**，超出就依 `output-spec.md` §3 的 degrade ladder 收斂（合併同質節點、收攏葉群），收不下的寫進省略表；使用者明說要「詳細／完整／faithful」時才放寬到 24，超過 24 一律先畫頂層。大綱頁的 Context 與主題頁的 ER 切片仍守其自身的稀疏定義，不因額度變寬而填滿。 4. **呼叫 provider**：載入唯一 adapter。單圖頁把四張表原樣交給 `diagram-design` 產完整 HTML；多圖頁**逐張交接**——每張圖各一套四表、各一次 provider 呼叫，取回 SVG 後由 `map` 組頁（見「多圖組頁」）。外派範圍、責任邊界與 provider 不可用時的處置見「繪圖 provider」。 5. **交付**：對照「硬約束」驗收語意保真與交付邊界，並說明圖中未包含的範圍。**不做繪後目視檢查**（不開瀏覽器截圖驗圖）——圖面品質由使用者目視回饋，收到反饋再退回第 4 步依 provider 規則修正重交。 ## 兩種標準產出 **大綱頁（每專案一頁，上手用）**：Context（系統與外界，內部零細節）＋ Container（要分別開的程式；每條線是通訊邊界，標協定）＋ 功能地圖（從路由檔自動抽）。詞彙表與核心實體可自動抽時一併附上。以「東西怎麼跑」為主體；查到的問題（命名與實作不符、設定懸空、檔案不一致）壓成單行提醒掛在圖下，不成為頁面主線。 **主題頁（每業務功能一頁，指派任務用）**：順序固定——狀態機（規則地圖）→ 循序圖（一條典型路線）→ flowchart（放大某一站的內部判斷，需要才附）→ ER 切片（壓底附錄；該主題的表＋直接鄰居三五張，不畫整庫）。圖與圖之間標對應關係並以同色呈現（如：狀態機某條線＝循序圖某站的成果＝flowchart 某出口）。**狀態機一律讀實作繪製，不信 docblock／註解**——註解過期會讓圖說謊。 **不入常備的項目（拍板移除，勿主動提議）**：system landscape、依賴規則檢查、部署圖（部署知識以 compose／IaC 檔為真相，要看再現畫即棄）、整庫 ER 大圖（任何場景不維護，找樞紐時現查即棄）。 ## 繪圖