17-listed

# 项目目录结构标准 > 通用 skill — 所有新项目（SaaS / 工具 / 内部系统 / 实验项目）按本标准建立目录结构。 > 与 [18-Git仓与安全](../18-Git仓与安全/) 配套使用。 ## 何时应用 - 新项目初始化时（创建仓库前必读） - 老项目整理 cleanup 时 - 添加新文档分类时（确认是否进现有 10 大类还是新建） ## 顶层结构（强制） ``` project-root/ ├── README.md 入口 — 一句话定位 + 导航 + 状态 ├── CHANGELOG.md 发布日志（Keep a Changelog 格式） ├── CLAUDE.md 项目级 AI 协作规范 ├── LICENSE 如适用（闭源项目可省） ├── .gitignore 根级 gitignore（参考 18-Git 规范模板） ├── .editorconfig 编辑器统一配置 │ ├── apps/ 业务代码（client / server / mobile / extension） ├── packages/ 共享代码（types / utils / ui，可选） ├── infra/ 基础设施（Docker / K8s / Terraform / CI 配置） ├── scripts/ 工具脚本（含 promote.sh） │ ├── docs/ 全部业务/产品/运营文档（10 大分类，见下） │ └── archive/ 项目级整体归档（旧版本/已废弃模块） ``` **单 app 的简化版**（早期 0-1 项目可省 `apps/`）： ``` project-root/ ├── client/ 平铺 ├── server/ ├── docs/ └── ... ``` > 团队规模 > 3 人 或 子项目 ≥ 3 个时**必须**升级到 `apps/` 结构。 ## docs/ 10 大分类（标准） | # | 目录 | 中文术语 | 内容 | 更新频率 | 默认 classification | |---|------|---------|------|---------|------------------| | 00 | `glossary.md`（文件，非目录）| 术语 | 术语 + 跨域资源索引 | 持续 | L0-L1 | | 01 | `01-strategy/` | 战略层 | vision / business model / 5 期演进 / tech architecture / north star metrics | 季度 review | L1 | | 02 | `02-planning/` | 规划资料 | roadmap / phase-1/2/3 / OKR / milestones / 验收标准 | 阶段 review | L1 | | 03 | `03-research/` | 参考资料 | competitors / indus