prd-maintenance

PRD 渐进式维护协议

基于 docs-writing-protocol 的 PRD 专属扩展。 去躁点判定、写入门槛、操作指令均继承基础协议，本协议只定义 PRD 特有的三层结构与文件管理。

---

核心原则

• 继承去躁点：纠错不记账；改契约/流程/规则/语义，就记账（详见 docs-writing-protocol）
• 三层结构：Facts（冻结事实）+ Snapshot（当前版本）+ Changelog（变更历史）
• 渐进演进：单文件 → 拆 Facts → 完全拆分，按需演进
• 供应商隔离：每个供应商/大需求独立目录，避免上下文混乱

---

1. 触发方式

• prd: path/to/prd — 进入 PRD 维护模式，设置 DocTarget
• prd: path/to/another — 切换 DocTarget
• stop prd — 退出 PRD 维护模式
• no-record — 本轮强制不记录（继承基础协议）

触发后 AI 自动识别文件结构（单文件 or 多文件），读取相关文件，进入持续维护模式。

---

2. 文件结构识别

单文件模式（小需求）

prd.md          # Facts + Snapshot + Changelog 三章节合一

部分拆分模式（中需求）

facts.md        # 独立冻结事实
prd.md          # Snapshot + Changelog

完全拆分模式（大需求）

facts.md
snapshot.md
changelog.md

AI 根据目录下文件自动判断模式，无需手动指定。

---

3. 三层结构

Facts（冻结事实）

业务域词典、核心约束、系统边界。基本不改，或改得很慢。

更新时机：术语定义变了 / 系统边界变了 / 核心约束变了

Snapshot（当前版本）

背景/目标、关键流程、关键规则、关键接口字段。反映"现在长什么样"。

更新时机：流程/规则/接口/目标范围变了

Changelog（变更历史）

每次变更只追加，格式如下（总计不超过 10 行）：

## YYYY-MM-DD：变更标题

**变更点**：
- 变更点 1
- 变更点 2

**影响面**：接口/规则/数据/灰度

**兼容策略**：向后兼容/双写/开关/迁移路径

---

4. 更新策略

变更类型	Facts	Snapshot	Changelog
术语/边界/约束变了	✅	✅	✅
流程/规则/接口变了	❌	✅	✅
修 bug / 纠错	❌	❌	❌

---

5. 演进路径

单文件 → 拆 Facts：Facts 超过 50 行，或需要被多个需求共享时

prd-split-facts: path/to/prd-dir

拆 Facts → 完全拆分：Changelog 超过 100 行，或多人协作需要清晰追溯时

prd-split-full: path/to/prd-dir

合并回单文件：需求缩小时

prd-merge: path/to/prd-dir