Coding Agents Love Decision Records

编码智能体倾向于依赖决策记录来维持项目上下文，但需避免将每个决策都转化为冗长的法庭记录。将架构决策记录（ADRs）存储为 Markdown 文件，明确区分已接受、提议和已被替代的决策，有助于智能体理解代码意图而非仅依赖实现细节。更新 ADR 时应仅保留当前文本，并通过 Git 历史记录变更日志，避免在 ADR 头部添加修订日志。