# project-doc 目录导读

创建人员：Codex  
文件职责：说明 `common/project-doc` 目录下项目规范、项目创建指南和项目管理模板的用途。  
管理规范/模板：../../全局规范.md；../../体系说明.md；项目规范.md。  
引用文件：项目规范.md；项目环境创建指南.md；本目录下全部 `*模版.md` 文件。  
记录方式：目录入口文档；新增或删除本目录正式文档时同步更新。

## 1. 目录定位

本目录保存通用项目规范和项目体系模板。

项目体系负责管理“一个项目本身”，包括项目目标、项目配置清单、启用体系、角色权限、目录结构、项目事项计划、项目执行日志、项目事项审计和项目级问题闭环。

项目体系不是需求体系、开发体系、实验体系的替代品。它负责把这些体系装进项目，并维护项目层面的治理入口。

## 2. 文件清单

| 文件 | 类型 | 作用 |
|---|---|---|
| 项目规范.md | 全局项目规范 | 说明项目体系的定位、核心流程、文档职责、业务子项目目录和 Git 管理边界 |
| 项目环境创建指南.md | 创建指南 | 指导项目管理员创建新项目和初始化项目体系 |
| 项目总览范本.md | 模板 | 创建项目根目录 `项目总览.md`，记录项目稳定基础信息、目标、周期、背景和关键入口 |
| 项目规范模版.md | 模板 | 创建项目根目录本地 `项目规范.md` |
| 项目配置清单模版.md | 模板 | 创建项目根目录 `项目配置清单.md`，记录启用体系、AI、角色、权限、工作空间和目录映射 |
| 项目事项总纲模版.md | 模板 | 创建项目事项总纲滚动账本，记录项目背景、目标、范围和状态 |
| 项目事项计划模版.md | 模板 | 创建项目事项计划滚动账本，记录阶段、里程碑、启用体系和任务 |
| 项目执行日志模版.md | 模板 | 创建项目管理执行日志，记录项目创建、体系启用、角色调整和关键管理动作 |
| 项目审计规范.md | 审核规范 | 定义项目创建、体系启用、权限、目录和项目级流程审计规则 |
| 项目事项审计报告模版.md | 模板 | 创建项目事项审计报告滚动账本 |
| 项目问题记录模版.md | 模板 | 创建非审计来源项目级问题闭环滚动账本；审计问题只做索引 |
| 项目变更记录模版.md | 模板 | 创建项目级变更记录，记录体系启用、目录调整、角色调整和关键口径变化 |

## 3. 推荐使用顺序

创建新项目时：

1. 先读 `../../全局规范.md`。
2. 再读 `项目规范.md`。
3. 按 `项目环境创建指南.md` 创建项目根目录和基础文档。
4. 用 `项目总览范本.md` 创建项目根目录 `项目总览.md`。
5. 用 `项目规范模版.md` 创建项目根目录 `项目规范.md`。
6. 用 `项目配置清单模版.md` 创建项目根目录 `项目配置清单.md`。
7. 按项目需要启用需求、编码、实验、案例分析、数据等体系。
8. 每启用一个体系，同步创建对应目录和本地规范。
9. 用项目事项总纲、项目事项计划、项目执行日志、项目事项审计报告、项目问题记录维护项目级证据链。

所有项目级文档默认采用 append-only 方式维护：最新项目事项计划、执行、审计、问题和变更记录追加到对应文件末尾。