概述
架构决策的理由若只存在于当事人记忆中，人员更替后同样的争论会重演。为重要决策记录背景、备选与后果、在提交前由受影响者评审、把记录与代码同库存放、变更时以新记录替代而非删除，可让组织记住为什么这样选择。
关键步骤
- 记录决策的背景、备选与后果。
- 提交前由受影响者评审。
- 与代码同库存储以便版本化与检索。
- 决策变化时替代而非删除。
验证
- 近期重要决策均有记录。
- 已变化的决策链接到后继记录。
- 记录含备选与后果。
- 有索引与关联。
决策点
应记录重要且难以逆转的决策，事事记录会稀释信号；过时记录应替代而非删除，删除会抹去原始理由并诱发重蹈覆辙。
适用范围
本条目围绕「架构决策记录工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。
建议在正式环境落地前先在预发或隔离环境演练一遍，把关键观测指标与负责人一并记录，确保出现异常时能快速定位并恢复。
# ADR 0042: Use cursor pagination for list endpoints
## Context
Offset pagination degrades on deep pages.
## Decision
Adopt cursor pagination across list APIs.
## Consequences
Clients must handle cursors; no arbitrary page jumps.