adr

ADR 技能為軟體工程團隊提供了一套簡潔的命令列介面，用於在開發工作流程中直接記錄、追蹤與管理架構決策紀錄 (ADR)。透過捕捉關鍵技術選擇的背景、理由與後續影響，此工具成為維持架構一致性、協助新成員快速上手以及避免重蹈覆轍的核心利器。它專為需要輕量級、版本控制方法來歸檔設計模式、函式庫選擇與基礎設施變更的開發人員、架構師與技術主管所設計。

• 支援標準化的 ADR 目錄結構初始化（支援常見路徑如 docs/adr 或 architecture/decisions）。

• 透過一致的模板快速建立新的決策紀錄，包含情境描述、決策分析與影響評估。

• 內建生命週期管理功能，包含取代過時記錄以及追蹤決策狀態（提案中、已採納、已棄用、已取代）。

• 強大的搜尋功能，可按關鍵字、標題或決策內容查詢既有的架構歷史。

• 提供列表與檢視指令，讓使用者無需離開終端機即可瀏覽專案的設計演進。

• 使用者需透過 /adr 指令搭配如 new、list 或 search 等動作進行互動。

• ADR 模板可在專案層級進行設定，確保團隊成員間的文件品質統一。

• 強烈建議將 ADR 檔案納入 Git 版本控制，以便與原始碼同步保存架構變更的歷史軌跡。

• 本工具相容於主流 AI 輔助開發環境，包含 Claude Code、Cursor 以及各類基於 CLI 的開發工作流程。

• 輸入通常包括新紀錄的標題或搜尋詞，輸出則為格式化的 Markdown 檔案，可作為專案文件與可搜尋的知識庫使用。