docs: codify decision consensus principle

This commit is contained in:
Codex
2026-05-27 03:15:00 +00:00
parent 2ef1290683
commit 3d978df356
+6
View File
@@ -8,6 +8,12 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台;本文
- `AGENTS.md` 只做顶级索引和一句话规则摘要;长期稳定、可复用的约束、入口、判定标准必须落到 `docs/reference/`,再由 `AGENTS.md` 提供索引。
- 过程记录、一次性排障、临时结论、带日期的流水账不得直接写成长期参考;需要沉淀时必须按 `docs-spec` 先蒸馏,再写入 `docs/reference/`
## Critical Decision Consensus Anti-Regression Rule
- P0: 决策共识优先于僵化门禁;这条适用于 CI/CD、部署、工具链、运行面、前后端架构、文档治理和其他开发改进,不只适用于某一条发布链路。
- P0: 防止回归旧路径、防止分叉乱路径是通用治理目标;默认做法是把迁移背景、当前标准路径、废弃路径、判断理由和收敛原则蒸馏到 `docs/reference/`,形成基于深入理解的决策共识。
- P0: 不得为了防回归而堆砌僵化的自检、预检、guard、gate、审计或证据收集;只有明确高价值风险无法靠长期参考、代码结构和标准入口自然收敛时,才新增最小门禁。
## Critical Guard Minimalism Rule
- P0: 架构迁移时,过时的自检、预检、guard、gate 一律优先拆除;禁止在旧门禁上继续修改、叠加例外或引入复杂度和噪声。