这个目录用于存放仓库级文档。
并不是仓库里的所有 Markdown 文件都属于这里。有些文档会有意放在它们所约束的代码或工作流旁边:
README.md、DESIGN.md和AGENTS.md保留在仓库根目录,因为它们是顶层入口文档apps/web/*与apps/admin/*的设计文档保留在各自界面旁边,因为它们直接规定这些界面的规范
高频入口文档保留在 docs/ 顶层:
RUNBOOK.mdCOMMAND-CARD.md
当前产品边界、内容规则与验收基线:
current-boundaries.mdcontent-model.mdacceptance-criteria.mdpublic-copy-audit-2026-09.md:公共官网固定文案审查与优化建议
系统、admin 与数据模型设计:
architecture.mdadmin-architecture.mdadmin-information-architecture.mdadmin-data-model.mdadmin-data-model-fields.md
开发、验证、部署与发布运维:
local-development.mdquality-assurance.mddeployment.mdproduction-config.mdlaunch-checklist.mdrepository-review-2026-06.mdserver-upgrade-and-cleanup.mdx-login-runbook.md
历史范围文档、阶段性路线图和不再作为当前事实来源的材料:
README.mdproduct/v1-scope.mdproduct/implementation-plan.md
仓库级的产品、架构与运维文档应放在 docs/ 下。
只有当文档明确属于某个应用或仓库入口点时,才应放在 docs/ 之外。
活跃文档应优先描述当前事实、当前流程和当前约束。
阶段性规划、历史范围或已经失效的叙述,应移入 docs/archive/,不要继续留在活跃文档路径中。