分享文档管理实践:docs 目录统一存放、渐进式披露、AGENTS.md 强制同步更新

文档的管理我是这么做的：
1. 文档统一放 docs 目录
2. 所有文档都遵循渐进式披露原则——也就每个文档都不大，但是会链接到相关文档，类似于主文档里面主要就是概要和目录，具体内容链接到章节对应的小文件
3. 根目录有一个 README 可以方便的索引到相关文档，类似于目录
4. AGENTS.md 强制要求修改功能要修改相关文档，有时候人也需要定期检查一下，即使加了规则也可能遗漏