场景 / 坑
我接着开发一个已经迭代过好几轮的项目，给 AI 喂了设计文档当参考。AI 按文档推断当前代码状态，下结论说”某功能缺外键约束""某字段挂在 A 表”。等真去读代码才发现：外键早就有了，字段也在另一张表——文档是几周前写的，代码早已跑在文档前面。
当时怎么做
- 错的那步：让 AI 先读文档再推断代码现状，按这个（已过期的）认知写了方案。
- 纠正：读真实代码才发现多处不符，额外花时间返工。之后改成——先让 AI 读代码确认现状，文档只用来补”当初为什么这么设计”。
心法
对已有代码库继续开发时，先让 AI 读真实代码建立认知，文档只用来补充意图和上下文，别拿文档代替代码状态——代码是唯一真相源，文档是可能过期的注释。
可自检练习
任务： 下次让 AI 在一个已有项目上加东西，先给它指真实代码（让它读相关文件、或跑一下看现状），确认当前到底是什么样，再把设计文档作为”意图参考”喂进去。
做对了长这样： AI 的判断建立在代码现状上，而不是过期文档上；当文档和代码冲突时，你和 AI 都以代码为准。
关联
- 上级路径：L2入口
- 相关卡：卡-喂上下文（L1 版”AI 只看得见你给它的”，本卡讲”给的若是过期文档反而误导”）、卡-计划不等于已完成（都关乎”喂进去 / 写出来的信息靠不靠谱”）