ADR
软件工程中记录重要技术决策的成熟模式，由Michael Nygard于2011年提出，记录决策背景、可选方案、选型理由和预期后果，后被ThoughtWorks等推广为最佳实践。
核心事实
时间轴 (近 90 天)
ADR 的流行是因为它解决了传统架构文档的两个顽疾：文档与代码脱节，以及决策背景随时间流失。
典型的ADR文件通常不超过一页，编号递增，存放在 `doc/adr` 目录下。
决策时间线是一种记录架构决策的轻量实践，可视为架构决策记录（ADR）的交互式变体，将关键取舍按时间顺序嵌入可视化文档并与 PR、代码差异关联。
SQL Server 2025 的优化锁定（Optimized Locking）通过版本化的事务锁机制避免锁升级，需依赖加速数据库恢复（ADR）和读已提交快照隔离（RCSI）。
移动基线（提高或降低平均recall@5阈值）需要显式的ADR决策，而不是为了让CI变绿而修改。
在人类团队中，代码评审、架构决策记录（ADR）和团队共享的心智模型共同抑制了架构漂移。
ADR 1（采用中央模型允许列表）的正向结果是合规与许可有了单一事实来源，负面结果是模型弃用或新增需要协调，且请求延迟因查询略有增加。
解决双源数据分歧的方法是按领域切分所有权：Joule 负责交易内帮助，自定义栈负责跨系统分析和专有策略 RAG，并将这种切分写进架构决策记录（ADR）。
缓解部落知识风险的办法是将其外化为架构决策记录（ADR）、README 注释或智能体指令文件。
破解供应商锁定的工程手段包括：将基础设施写成Terraform或Pulumi代码纳入自有仓库、要求所有设计讨论以ADR形式留档、把CI/CD流水线配置放在自己控制的账号下。
还有 8 条时间轴事件
全部知识事实 (20)
架构决策记录（ADR）是Michael Nygard在2011年提出的实践
75%已验证架构决策记录（ADR）是Michael Nygard在2011年提出的一种轻量级文档实践
70%已验证架构决策记录（ADR）是软件工程中用于系统化记录重要技术决策的轻量文档格式，通常包含决策背景、可选方案、最终选择及其权衡理由
65%待验证ADR（Architecture Decision Records，架构决策记录）是软件工程中记录技术选型原因、替代方案及放弃理由的决策日志实践
60%待验证信息层的目标是让Agent全面理解项目，包括项目级规则文件（如Cursor的.cursorrules、Windsurf的.windsurfrules）、架构决策记录、API契约文件、依赖关系图谱
60%待验证ADR（Architecture Decision Record）是由Michael Nygard提出的一种轻量级文档实践，用于记录项目中每个重要的架构决策及其背景、理由和后果
60%待验证过程笔记文件的做法与软件工程中的架构决策记录（ADR）实践高度相似，ADR由Michael Nygard在2011年系统化提出
60%待验证ADR 的流行是因为它解决了传统架构文档的两个顽疾：文档与代码脱节，以及决策背景随时间流失。
50%待验证典型的ADR文件通常不超过一页，编号递增，存放在 `doc/adr` 目录下。
50%待验证决策时间线是一种记录架构决策的轻量实践，可视为架构决策记录（ADR）的交互式变体，将关键取舍按时间顺序嵌入可视化文档并与 PR、代码差异关联。
50%待验证SQL Server 2025 的优化锁定（Optimized Locking）通过版本化的事务锁机制避免锁升级，需依赖加速数据库恢复（ADR）和读已提交快照隔离（RCSI）。
50%待验证移动基线（提高或降低平均recall@5阈值）需要显式的ADR决策，而不是为了让CI变绿而修改。
50%待验证在人类团队中，代码评审、架构决策记录（ADR）和团队共享的心智模型共同抑制了架构漂移。
50%待验证ADR 1（采用中央模型允许列表）的正向结果是合规与许可有了单一事实来源，负面结果是模型弃用或新增需要协调，且请求延迟因查询略有增加。
50%待验证解决双源数据分歧的方法是按领域切分所有权：Joule 负责交易内帮助，自定义栈负责跨系统分析和专有策略 RAG，并将这种切分写进架构决策记录（ADR）。
50%待验证缓解部落知识风险的办法是将其外化为架构决策记录（ADR）、README 注释或智能体指令文件。
50%待验证破解供应商锁定的工程手段包括：将基础设施写成Terraform或Pulumi代码纳入自有仓库、要求所有设计讨论以ADR形式留档、把CI/CD流水线配置放在自己控制的账号下。
50%待验证AI 模型本身没有项目记忆，每次开启新会话都是失忆状态，因此需要把关键技术决策沉淀为 ADR 文件供 AI 读取
50%待验证初始化后项目根目录会生成 AGENTS.md 说明文件、context 目录和 ADR 等技术文档
50%待验证信息层的结构化设计包括项目级规则文件（如Cursor的.cursorrules、Windsurf的.windsurfrules）、架构决策记录（ADR）、API契约文件（如OpenAPI Spec）及依赖关系图谱
50%