ARCHITECTUREmd
可以先理解为:用技术架构文档约束AI开发
ARCHITECTUREmd 像施工图。它不负责讲产品为什么值得做,而是告诉开发者和 AI:这个系统用什么材料、哪些墙不能拆、数据怎么流、上线时要守哪些边界。
关键结构图
中心是代码项目,四周连接技术栈、数据契约、模块边界和部署环境四个约束框。
What
ARCHITECTUREmd 是把产品的技术边界、数据形态、依赖和部署方式写清楚的项目架构文档。
ARCHITECTUREmd 是一种项目级技术架构文档,用于约束实现方式、依赖选择、数据 schema、模块边界、运行环境和部署策略。它的边界是技术实现和系统约束,不替代 PRD、设计稿或内容文档。
StructureARCHITECTUREmd = 技术栈 + 数据契约 + 模块边界 + 部署约束
When
当项目开始进入实现、多人协作、AI 代码生成、数据导出或部署前,需要 ARCHITECTUREmd 把技术边界固定下来。
How
先列出技术栈和关键依赖,再定义数据模型、路由、构建、部署和性能预算。每个决定都要说明为什么这样做,以及什么行为被排除。
Examples
一个 Next.js 项目在 ARCHITECTUREmd 里写明数据来自静态 JSON,前端不运行时连接外部工作台,AI 就不会误把临时资料库当成正式数据库。
一个图谱产品写明 WebGL、LOD 和移动端降级策略,后续优化就不会只追求桌面效果。
来源
类型:工程实践 / 项目文档
事实线:软件项目通常需要用架构文档记录关键技术决策、系统边界和实现约束,以降低多人协作和 AI 协作中的偏移。
依据:软件架构文档实践、ADR/technical design document 方法、spec-driven development 项目经验。
边界:适合有真实代码、数据和部署约束的项目;早期想法阶段可以先保持轻量。
常见误读:不要把 ARCHITECTUREmd 写成技术名词清单。它必须能约束实现选择。