ADR-XXX：决策标题
ADR（Architecture Decision Record，架构决策记录）用于记录重要的技术决策。 本模板遵循
docs/STYLE-GUIDE.md规范。 📄 查看已填写示例：Monorepo Adoption | AI SDK 选型
状态
- 提议 / 已接受 / 已废弃 / 已替代
背景
描述当时面临的问题或需要做出的选择。
示例：随着业务增长，前端项目从单仓库发展为多仓库，组件复用困难，构建和发布成本增加。
决策
明确记录最终做出的决策。
示例：采用 pnpm workspace + Turborepo 构建 Monorepo，统一管理组件库、工具库和业务应用。
备选方案
列出所有认真考虑过的备选方案，并分析优缺点。
| 方案 | 优点 | 缺点 |
|---|---|---|
| 方案 A | ... | ... |
| 方案 B | ... | ... |
| 方案 C | ... | ... |
权衡分析（Trade-off）
| 维度 | 权重 | 方案 A | 方案 B | 方案 C |
|---|---|---|---|---|
| 开发效率 | 30% | 8 | 7 | 6 |
| 维护成本 | 25% | 7 | 8 | 5 |
| 性能 | 20% | 6 | 7 | 8 |
| 团队熟悉度 | 15% | 9 | 6 | 4 |
| 生态成熟度 | 10% | 8 | 7 | 5 |
| 加权总分 |
注：权重和分数根据团队实际情况调整。
影响
描述该决策对项目、团队、流程的影响。
- 需要修改哪些代码或配置？
- 需要哪些团队配合？
- 对现有流程有什么改变？
风险与缓解措施
| 风险 | 影响 | 可能性 | 缓解措施 |
|---|---|---|---|
| ... | 高/中/低 | 高/中/低 | ... |
相关文档
- 相关 ADR：ADR-YYY
- 设计文档：docs/design/xxx.md
- 会议记录：meeting-notes/xxx.md
决策人
- 提出人：
- 评审人：
- 批准人：
日期
- 提出日期：YYYY-MM-DD
- 生效日期：YYYY-MM-DD
使用说明：复制本模板到
docs/adrs/或项目对应目录，替换XXX为编号，填写内容。