设计文档 = 两套系统的合同：把话说死，才

研究材料刚定稿，目标、架构、模块全追得到出处。下一步让 AI 写代码，我却在终端前卡住了。

这些“想清楚”的东西，AI 写代码时真读得到吗？知识库管方案对不对，工程系统管代码坏没坏。中间隔着一道缝，各说各话。

最怕同一份事实在两边各写一遍。知识库里一套，项目里再抄一套，各自演化。这叫单源漂移病，迟早对不上。

解法是把设计文档变成两套系统的合同。拷进项目做 docs/design.md，两边共同引用、共同更新。再把内容翻译成硬输入：架构进施工规范，命令进验收清单，模块拆成任务，假设分流到验证区。

接缝只解决对齐，不保证合同写得对。翻译只搬运内容，不产生新知识。实现发现不一致，就得回去改合同、重新审批，不能偷偷改代码。

真实世界也这么干。前后端共用接口描述文件，云团队共用资源清单。谁都不另写一套，改乱了联调就红。