# 完成架構 (Finalize Architecture) 技能指南 ## 概述 `finalize-architecture` 是 Architect Pipeline 的最後一個步驟,在挑戰審查與修訂完成後,對架構文件進行最終完整性檢查與格式驗證。 ## 輸入與輸出 ### 輸入 - `docs/architecture/{feature}.md` ### 輸出 - 最終 `docs/architecture/{feature}.md` ## 驗證步驟 1. **章節完整性檢查**:18 個必備章節是否都存在與實質內容 2. **Mermaid 圖表驗證**:至少 3 張圖表(System、Sequence、Data Flow)、語法正確、無孤兒元件 3. **資料庫 Schema 驗證**:所有表格含欄位、類型與限制式、索引有理由 4. **API 合約驗證**:所有端點含方法、路徑、請求/回應結構 5. **ADR 驗證**:至少 1 個 ADR,含 Context、Decision、Consequences、Alternatives 6. **可追溯性驗證**:每個元素是否可追溯到 PRD 需求 7. **格式驗證**:章節順序、Markdown 語法、無外部檔案參照 8. **架構審查閘道**:確認挑戰審查的 Gate Decision 是否為 PASS 或 CONDITIONAL PASS ## 完成檢查清單 - [ ] 18 個必備章節存在且實質(或是 N/A with reason) - [ ] 至少 3 張 Mermaid 圖表 - [ ] Database Schema 有完整表格定義 - [ ] API Contract 有完整端點規格 - [ ] 至少 1 個 ADR 且格式完整 - [ ] 所有元素可追溯到 PRD 需求 - [ ] 架構審查閘道為 PASS 或 CONDITIONAL PASS - [ ] Risks 區段已填寫 - [ ] Open Questions 區段已填寫(或明確寫 None) ## 不應做的事 - 不設計新架構 - 不改變架構決策 - 不新增未在挑戰審查中驗證的重大內容 - 不產生 `docs/architecture/{feature}.md` 以外的檔案