返回洞察列表
工程化思维
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" />