今天在博客园看到一篇 AI 老六的文章，标题是《AI Agent、架构决策记录与工程上下文治理》。读完之后我只有一个想法：每个用 AI 写代码的团队，都应该立刻开始写 ADR。

什么是 ADR？

ADR（Architecture Decision Record，架构决策记录）就是记录「为什么这么设计」的文档。

代码记录了「怎么做」，但没有记录「为什么这么做」。比如你看到一段奇怪的 if-else 逻辑，代码告诉你它在判断什么条件，但不会告诉你——当初是因为一个线上事故才加了这段防御代码，去掉就会炸。