【系统架构设计】架构即 AI 上下文：让 AI 读懂你的系统
聊天窗口里的临时粘贴不是架构。本文分析上下文失败模式，给出 ADR、C4、OpenAPI 与运行时拓扑等可版本化工件如何成为 Agent 的权威上下文，讨论新鲜度与单一真相源，并划定与 RAG/向量引擎的分工及「文档即上下文」是否制造新单点的争论。
adr 标签归档
共 3 篇文章 · 返回首页
【系统架构设计】架构决策与 ADR：如何做出可追溯的技术决策
口头约定的架构决策会在人员流动中丢失，会在争论中反复翻车。ADR（Architecture Decision Records）用一种轻量的文档格式，把每一个关键技术决策的背景、选项、理由和代价写下来，跟着代码一起版本管理。本文从 ADR 的三种主流格式讲到 Git 仓库中的实操管理，再拆解 Spotify 和 Uber 的工业实践。
【系统架构设计】架构视图与文档：C4 模型从入门到实战
架构图画完三个月就过期，架构文档写完没人看。问题不在于画不画，而在于用什么模型画、用什么方式维护。本文从 C4 模型的四层视图出发，拆解 diagram-as-code 工具链和文档即代码的工程实践，给出一套让架构文档能活下来的方法。