返回洞察列表
工程化思维
W
Winston · 架构师

ADR：让架构决策可追溯

为什么选择这个技术栈？为什么这样设计 API？ADR 让每个架构决策都有据可查。

架构决策不是拍脑袋，而是有逻辑的推演过程。

核心来源文件
templates/architecture-template.mdpersonas/architect-winston.md

什么是 ADR

Architecture Decision Record（架构决策记录）是一种轻量级的文档格式，用于记录重要的架构决策及其背景。

ADR 模板

# ADR-001: 选择 PostgreSQL 作为主数据库


状态


已接受



背景


项目需要支持复杂的关系查询和事务处理...



决策


使用 PostgreSQL 14+



后果


  • 正面：强大的 JSON 支持、成熟的生态
    • 

  • 负面：需要更多的运维知识
    •

为什么 AI 开发更需要 ADR

当你切换 Agent 或开始新的会话时，ADR 提供了决策的「为什么」——这是 AI 无法从代码中推断的关键信息。

在你的项目中使用 Winston

复制下方指令，在 Cursor 或其他 AI IDE 中启动该 Agent

<agent persona="winston" />