architecture-decision-records

此技能為團隊提供了一個結構化的框架，用以記錄重大架構決策的背景、基本原理與後續影響。通過使用如 MADR (Markdown 架構決策記錄) 或 Y-Statement 等標準化格式，團隊能夠有效地傳達技術策略、確保專案間的一致性，並為新成員加入或審查過往設計決策提供歷史透明度。該技能旨在作為專案知識的動態儲存庫，防止長期開發過程中設計背景資訊的遺失。

• 標準化模板：包含 MADR、輕量級 ADR、Y-Statement 以及針對棄用決策的模板，以適應不同複雜度的專案需求。

• 生命週期管理：協助追蹤決策從「提議」、「接受」、「棄用」到「被取代」的狀態變更。

• 決策驅動因素：協助明確定義需求，例如 ACID 合規性、擴展性、安全性和開發者體驗 (DX)。

• 後果分析：鼓勵針對每個技術路徑深入評估其正面效益、負面影響及潛在風險。

• 文件最佳實踐：提供關於何時編寫 ADR (如採用新框架、API 設計) 以及何時無需編寫 (如修復 Bug、小版本更新) 的明確指導。

• 適用對象：負責複雜系統設計或團隊技術方向調整的資深開發者、系統架構師及工程經理。

• 使用時機：在設計審查會議中或規劃大型基礎設施變更時使用，確保所有相關人員對決策背後的「為什麼」達成共識。

• 輸入需求：需要專案需求、技術限制與候選技術；輸出為可直接整合至版本控制文件資料夾中的結構化 Markdown 檔案。

• 整合性：設計用於 Claude Code 環境中，並與其他專案管理及開發工具協作，協助維護高完整性的架構歷史紀錄。