1. 项目文档自动化生成：一个被低估的“上下文锚点”工程
大多数人把 Claude Code 当成一个更快的代码补全器——敲几行注释，它吐出函数体；写个 TODO，它自动实现。这没错，但只用了它 30% 的能力。真正让团队研发节奏稳下来、新人上手快起来、重构不踩坑的关键，不是它写了多少行代码，而是它能不能在每次提交前，自动生成一份准确、一致、可验证的项目文档。
我最近在三个中型后端项目（Java/Spring Boot、Python/FastAPI、TypeScript/NestJS）里落地了这套方案。结果很反直觉：文档生成环节本身只占整个 AI 辅助工作流 8% 的时间，但它把后续所有环节的上下文丢失率降低了 62%。为什么？因为 README 不是给人看的，它是给 AI 看的“项目宪法”；ARCHITECTURE.md 不是画给架构师的，它是模型理解模块边界的“内存快照”；API.md 更不是接口清单，它是模型调用外部服务时的“类型守卫”。
这个结论不是理论推演出来的。是在一次紧急修复中撞出来的：当时一个同事用 Claude Code 重构了一个核心支付网关模块，AI 很快生成了新代码，但漏掉了对旧版回调签名的兼容处理——因为它的上下文里没有那一页被遗忘在 Confluence 里的“历史协议变更记录”。我们临时补了个 CLAUDE.md，强制它读完再动代码，问题当场消失。那一刻我意识到：文档不是产出物，是输入约束；不是终点，是起点。
本文讲的不是“怎么让 AI 写文档”，而是“怎么让 AI 在写任何代码之前，必须先读懂你项目的三份核心宪法”。它直接承接上一节《5.2 项目架构自动梳理》的输出，把
