项目文档

为长期维护的仓库建立简洁、可追溯的项目级文档。项目文档记录稳定上下文，不替代功能规格：功能规格仍属于 docs/specs/。

先审计，后写入。没有用户对建议范围的明确确认时，不创建或修改任何文件。

审计

在仓库中只读检查以下证据：

• README.md、AGENTS.md、docs/ 及其他现有说明文档。
• 目录结构、主要模块边界和测试位置。
• 已验证或可从配置确认的启动、构建、测试和检查命令。
• 包管理器、运行时、部署配置与外部服务集成。
• 一段有代表性的近期 Git 历史，以识别活跃区域和文档可能过时的风险。

不要把缺失的信息补成猜测。Git 历史不可用或证据不足时，明确说明限制。

输出一份简短的“文档审计与建议”，包含：