完善AI-NSES文档治理规则
This commit is contained in:
@@ -16,6 +16,7 @@ AI-NSES 推荐目录和本项目当前目录的映射如下:
|
||||
| 项目长期上下文 | `CONTEXT.md` | 产品目标、系统组成、技术栈、业务领域和外部系统边界。 |
|
||||
| 项目当前状态 | `PROJECT_STATE.md` | 当前 checkpoint、优先级、已确认事实、Known Issues 和 Next Steps。 |
|
||||
| 项目文档索引 | `docs/project/README.md` | 当前项目专属文档总索引和权威来源说明。 |
|
||||
| 项目级 Overlay | `docs/project/ai-nses-project-overlay.md` | 当前项目在 AI-NSES 之上的需求门禁、核心概念守门、V4 文档和 agent 交接规则。 |
|
||||
| 通用规范 | `docs/import/reusable/` | 可复制到后续项目的通用标准、开发规范和模板。 |
|
||||
| 当前项目需求 / Spec | `docs/project/requirements/` | 当前阶段仍沿用既有目录保存功能需求和方案。 |
|
||||
| 当前项目集成契约 | `docs/project/integrations/` | SuperAgent、AgentBus 和 MCP 对接资料。 |
|
||||
@@ -37,10 +38,11 @@ AI-NSES 推荐目录和本项目当前目录的映射如下:
|
||||
|
||||
## 4. 后续演进原则
|
||||
|
||||
- 新增重要 Feature 时,优先形成独立 Spec。
|
||||
- 新增重要 Feature 时,优先形成独立 Spec;涉及 V4 业务卡、SuperAgent 入站、前后端接口、权限、安全、审计或普通用户页面时,必须按 `docs/project/ai-nses-project-overlay.md` 先形成或更新 Spec / Change Request。
|
||||
- 新增重要架构决策时,新增 ADR,不覆盖历史。
|
||||
- 新增稳定业务概念时,再补 Domain 文档。
|
||||
- 新增跨模块流程时,再补 Workflow 文档。
|
||||
- 后端、前端、测试或文档 agent 的任务交接,应使用 AI-NSES handoff 结构,并补充本项目 overlay 要求的影响范围和输出要求。
|
||||
- 只有当迁移能降低理解成本时,才考虑移动旧文档。
|
||||
- `PROJECT_STATE.md` 是唯一允许高频更新的顶层项目状态文档。
|
||||
|
||||
@@ -53,7 +55,8 @@ AI-NSES 推荐目录和本项目当前目录的映射如下:
|
||||
3. `PROJECT_STATE.md`
|
||||
4. `README.md`
|
||||
5. `docs/project/README.md`
|
||||
6. 当前任务相关的需求、集成、安全或前后端协作文档
|
||||
6. `docs/project/ai-nses-project-overlay.md`
|
||||
7. 当前任务相关的需求、集成、安全或前后端协作文档
|
||||
|
||||
涉及接口、权限、审计、酒店隔离或敏感数据返回时,必须阅读 `docs/project/security-access-control-boundary.md`。
|
||||
|
||||
@@ -66,6 +69,7 @@ AI-NSES 推荐目录和本项目当前目录的映射如下:
|
||||
- `PROJECT_STATE.md` 是否需要更新。
|
||||
- 需求、Spec、Workflow、ADR 或集成契约是否需要更新。
|
||||
- 安全、权限、酒店隔离和审计边界是否受影响。
|
||||
- 如果是 V4 需求,需求追踪表是否已更新,是否符合项目级 overlay 的核心概念守门和 agent 交接规则。
|
||||
|
||||
如果没有文档变化,应在交付说明中明确:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user