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 解释决策存在的原因，而不仅仅是改变了什么。
• 备选方案和后果是诚实的。
• 状态清晰。
• 相关文档已链接。