土法炼钢兴趣小组的算法知识备份

发布来自土法炼钢兴趣小组的知识、笔记、进展和应用。主题包括数据结构和算法、编程语言、网络安全、密码学等。

documentation 标签归档

共 3 篇文章 · 返回首页

【系统架构设计】架构即 AI 上下文：让 AI 读懂你的系统

2026-08-03 | architecture | #adr #c4 #architecture-as-context #rag #openapi #topology #ai-agent #documentation #ssot

聊天窗口里的临时粘贴不是架构。本文分析上下文失败模式，给出 ADR、C4、OpenAPI 与运行时拓扑等可版本化工件如何成为 Agent 的权威上下文，讨论新鲜度与单一真相源，并划定与 RAG/向量引擎的分工及「文档即上下文」是否制造新单点的争论。

【系统架构设计】架构决策与 ADR：如何做出可追溯的技术决策

2026-04-13 | architecture | #adr #architecture-decisions #documentation #engineering-practice #decision-records

口头约定的架构决策会在人员流动中丢失，会在争论中反复翻车。ADR（Architecture Decision Records）用一种轻量的文档格式，把每一个关键技术决策的背景、选项、理由和代价写下来，跟着代码一起版本管理。本文从 ADR 的三种主流格式讲到 Git 仓库中的实操管理，再拆解 Spotify 和 Uber 的工业实践。