architecture-decision-records

架構決策記錄 (ADR) 為專案生命週期中記錄關鍵技術選擇提供了結構化的方法論。透過捕捉架構模式、技術選型與設計權衡背後的「原因」，此技能協助團隊避免決策疲勞與架構記憶喪失。它專為需要維護組織知識、促進新成員順利入職，並確保歷史決策保持透明與可審查性的技術負責人、軟體架構師與工程團隊設計。

• 標準化文件：包含標準 MADR 格式、輕量級 ADR、Y-語句與棄用記錄的模板。

• 決策生命週期管理：追蹤決策從提案到被接受、棄用或取代的演變過程。

• 策略清晰度：明確區分實作細節與重大架構變更，協助團隊優先處理需要正式記錄的事項。

• 情境歸檔：對於記錄資料庫選擇、API 設計、安全架構與整合模式相關的取捨至關重要。

• 團隊共識：確保所有利益相關者理解複雜技術決策背後的邏輯，減少程式碼審查與未來重構期間的摩擦。

• 在啟動新專案或進行技術堆疊重大調整（例如框架採用、資料庫遷移或重大安全性變更）時使用此技能。

• 建議針對版本微幅升級、例行設定變更或錯誤修復跳過此步驟。

• 輸入通常涉及技術需求、效能基準測試與考量過的替代方案。

• 輸出為儲存在儲存庫中的結構化 Markdown 文件，作為設計邏輯的單一事實來源。

• 與現有的儲存庫文件工作流程無縫整合，以維護技術演進的可搜尋歷史紀錄。