Karthick-Ramachandran/recall-os

技能：建立 ADR

目的

記錄持久的架構決策，讓未來的人類與代理無需重新發現或與之矛盾。

輸入

• 決策主題。
• 背景與限制條件。
• 考慮過的選項。
• 建議或選定的決策。

必要閱讀

• docs/10-architecture/ARCHITECTURE.md
• docs/10-architecture/FILE_WRITE_POLICY.md
• docs/20-security/SECURITY_MODEL.md
• docs/adrs/ 中相關的現有 ADR

輸出文件

• docs/adrs/ADR-####-<slug>.md

流程

1. 判斷此變更是否需要 ADR。
2. 找出下一個 ADR 編號，且不重複使用現有編號。
3. 撰寫背景、決策、替代方案、影響與相關文件。
4. 除非人類已接受決策，否則將狀態設為 Proposed。
5. 連結相關的 PRD、架構文件、功能文件與安全文件。

停止條件

若遇到以下情況，則停止並請求人類決策：

• 決策會改變安全態勢、網路行為、遙測功能、檔案寫入、認證、密碼、雲端或執行時期 MCP。
• 請求的決策與已接受的 ADR 衝突。
• 決策實際上尚未確定，應維持為提案。

品質標準

• ADR 應說明決策存在的原因，而不僅僅是變更的內容。
• 替代方案與影響需如實陳述。
• 狀態必須清楚明確。
• 相關文件應相互連結。