决策日志
按时间顺序记录组织或项目中做出的重要决策的文档。留下决定事项及其依据，以便日后查阅。
决策日志（Decision Log）是指按时间顺序记录组织或项目中做出的重要决策的文档。不仅记录决定事项本身，还把当时的情况 / 选项 / 判断依据都留下来，之后就能追溯查阅“为什么这样决定”。在软件开发领域，使用一种称为 Architecture Decision Record（ADR）的形式。
与会议纪要的区别
| 项目 | 会议纪要 | 决策日志 |
|---|---|---|
| 对象 | 单次会议的记录 | 跨项目 / 组织的决策 |
| 粒度 | 发言 / 讨论的过程 | 只记决定事项及其依据 |
| 可检索性 | 按日期 | 按主题 / 类别横向检索 |
| 查阅时机 | 会议刚结束时 | 几个月后 / 几年后 |
| 形式 | 按时间顺序的讨论记录 | 带独立 ID 的结构化记录 |
决策日志的模板
在 ADR 中，每项决定建 1 个文件，记录如下项目。
# ADR-042: 采用 API Gateway
## 状态
已批准（2026-05-15）
## 背景
需要统一微服务之间的认证。
## 考虑过的选项
1. AWS API Gateway
2. 自行实现的认证代理
3. Kong
## 决定
采用 API Gateway
## 依据
- 在现有 AWS 账户内即可完成
- 运营成本最低
- 每百万次请求 $3.5，还可利用免费额度
## 影响
延迟增加约 30ms。在可接受范围内
应留下决策日志的决策
- 事后推翻需要付出成本的决定（架构、合同）
- 从多个选项中选出 1 个的决定
- 对外部相关方有影响的决定
- 涉及合规 / 安全的决定
- 3 个月后可能被问到“为什么这样做”的决定
决策日志带来的效果
常被提到的决策日志的效果是：“翻旧账式的重复讨论”减少，以及新成员能够自己追溯过去的经过，入职融入更快。在此基础上要把握的一点是，组织的“集体智慧”不是积累在个人的脑中，而是积累在文档中。
运营上的注意
决策日志重要的不是“写下来”，而是“保持被查阅的状态”。在会后跟进中，养成一定把决定事项转记到决策日志的习惯。从会议纪要到决策日志、从行动项到任务管理工具，分成两条线来流转，两边的记录事后都容易追溯。