ADR 0099 template

NNNN · <决策标题>

• 状态：Proposed / Accepted / Superseded by NNNN / Deprecated
• 日期：YYYY-MM-DD
• 范围：项目级 / 包级（pkg/xxx）

背景

简述问题与触发场景。避免演进流水账，只描述需要决策的客观矛盾。

决策

做了什么选择。用一句可操作的规则表述（例："构造器在参数非法时返回 error，不 panic"）。

备选方案（被拒）

• 方案 A：描述 + 被拒原因
• 方案 B：描述 + 被拒原因

影响

• 正向：适配性、可测性、性能等
• 代价：调用方需要承担的额外工作
• 关联约束：涉及的项目硬约束（指向 CLAUDE.md 或 .golangci.yml）

代码引用

• 落地位置：pkg/xxx/file.go:N
• 首次生效 commit：<hash>（落地时补）