1.8 KiB

Raw Blame History

架構挑戰 (Challenge Architecture) 技能指南

概述

challenge-architecture 是 Architect Pipeline 的第三個步驟，用來對架構決策做高強度審查、驗證 PRD 可追溯性、偵測過度設計與不足設計。此技能以安靜的批次審計模式運作，不會互動式提問。

輸入與輸出

輸入

docs/architecture/{feature}.md
docs/prd/{feature}.md

輸出

更新後的 docs/architecture/{feature}.md

審計模式

此技能以安靜審計 / 批次審查模式運作：

完整閱讀 PRD 與架構文件
安靜執行所有驗證階段
產出單一結構化審查報告
直接將所有修補套用到架構文件
不會一次問一個問題或互動式提示

審計階段

可追溯性：每個架構元素是否回溯到 PRD 需求
覆蓋度：每個 PRD 需求是否有架構對應
擴展性：服務是否能獨立擴展、是否有單點失敗
一致性：一致性模型是否明確、Race condition 是否識別
安全性：認證/授權邊界是否定義
整合：外部系統整合是否識別、失敗模式是否定義
可觀測性：Logs、Metrics、Traces 是否完整
資料完整性：資料是否可能遺失、交易邊界是否合適
過度設計偵測：過於複雜的架構決策
不足設計偵測：遺漏的需求對應

審查輸出格式

Traceability Gaps
Missing Decisions
Over-Engineering
Under-Engineering
Risks
Required Revisions

閘道決策

PASS：所有修補已套用，無剩餘阻擋
CONDITIONAL PASS：存在不阻擋 Planner 交接的小缺口
FAIL：需要重大修訂，需回到 design-architecture

不應做的事

不以互動方式提問
不改變 PRD 範圍
不從頭設計架構
不做實作層級決策
不拆分任務