# AI 项目开发流程框架

这是一个可复制到任意软件项目的治理框架。它保留“项目文档 + AI 协作 + 项目输入 + 源码 + OpenSpec”的完整骨架，只将项目专属事实改为通用占位符；不包含业务源码、接口、账号、设计资产或历史项目记录。

## 使用方式

1. 复制本目录作为新项目仓库的治理层，或将其合并到已有仓库根目录。
2. 填写 `01-项目文档_docs/00-项目管理/项目总控入口.md` 中的项目事实、当前基线、责任人与初始化要求。
3. 在 `04-新项目源码_source` 放置或链接新项目源码；在 `03-项目输入_project-inputs` 放置经授权的输入资料。
4. 从 `02-AI协作_ai-workflow/04-文档模板_templates` 生成模块上下文包、规格、报告和集成材料。
5. 以 `项目总控入口.md` 中的 `current_baseline` 作为唯一当前基线记录，随后才开始开发或验收。

## 目录原则

- `01-项目文档_docs`：项目管理、需求分析、UI 标准、模块、报告、问题、归档和项目记录。
- `02-AI协作_ai-workflow`：协作入口、Agent、Skill、Prompt、文档模板和工具适配。
- `03-项目输入_project-inputs`：获授权的需求、设计、旧系统或接口资料；默认只读。
- `04-新项目源码_source`：实际产品代码；本框架不提供示例业务代码。
- `openspec`：可选的规格变更与归档目录；不用 OpenSpec 时可删除。

## 最小启用集

首次启动只需完成以下文件：

1. `AGENTS.md`
2. `01-项目文档_docs/00-项目管理/项目总控入口.md`
3. `01-项目文档_docs/00-项目管理/03-交付验收/功能模块总进度表.md`
4. 当前模块的上下文包

启动使用 `01-项目文档_docs/00-项目管理/项目总控入口.md` 的“初始化完成条件”；重大决策和异常处置使用 `01-项目文档_docs/00-项目管理/02-流程与规范/决策与风险管理.md`，发布使用 `03-交付验收/发布与回滚流程.md`。对项目负责人进行周期性汇报时，使用 `01-项目文档_docs/07-项目记录/01-启动与规划记录/项目阶段汇报模板.md`；汇报只汇总当前事实并链接至看板、基线和证据。

其余规则按任务需要读取，避免开发者被管理资料淹没。