weichenandCursor
7778559201
Accept DOCREV decision gates, archive design short-term, and mark FEATURE-MATRIX partial as implementation starts on feature branch. Co-authored-by: Cursor <cursoragent@cursor.com>
1.7 KiB
1.7 KiB
ADR：文档 Version / Revision 边界与决策门
状态
已接受（2026-09-13，用户确认 DOCREV 整改实施计划）
背景
受控文档此前只有当前 output.md 与 SHA，无法表达「智能体基线 + 后续人工修改」的业务版本语义；自由文档每次保存 +1 的 current_version_id 与本需求冲突。
决策
- 版本边界：模板或一次成功提交的智能体/智能体小队产物开启
Version；人工每次服务端成功保存只增加该 Version 内的Revision，不增加面向用户的版本号。 - high/critical 候选：风险达到
high或critical的 agent candidate，必须经编制负责人二次确认后才能CommitAgentVersion。 - 首发范围：Wave 1–5 仅覆盖受控文档；自由文档统一读模型与 UI 语义切换放在 Wave 6。
- 根表指针列：统一
ledger_*/head_*前缀；禁止与freeform_documents.current_version_id（00008 每-save+1 legacy）同名承载新语义；旧列迁移时改名为legacy_version_id。 - Goose：从 00028 起递增；不得硬占用并行分支可能冲突的旧号。
- 保留策略：受控文档随项目/法规保留；自由文档默认 365 天可配置，禁止静默硬删。
- 发布 blocker：方案评审与 Wave 落地阶段不擅自写入 gap-matrix；纳入发布范围后再新增行。
后果
- 实施必须按 Wave 0→6 顺序；禁止先上前端颜色标记再补快照事实源。
document_records.version/content_sha256在兼容期由 ledger 同事务投影，稳定后退役。- 详细表结构、API、状态机见 ../system-design/document-revision-management.md。