docs(governance): 治理层 × rules/.archived/feedback 双向打通#15
整体缺少了和 rules 中 feedback 的联合点
前一个 PR(#14)建立了治理层,但没有与已存在的 rules/.archived/feedback/ FB 归档机制做连接。这导致:
rules/.archived/feedback/
rules/.archived/feedback/README.md 从 36 行扩到 123 行,包含 7 节完整规格:
rules/.archived/feedback/README.md
OPEN → RESOLVED / ACCEPTED
§4.3/4.4/4.5 不再重复 FB 模板 / 状态机 / 索引描述,统一改为"见 rules/.archived/feedback/README.md §X"。单一事实源原则。
rules/.archived/feedback/README.md §X
delivery-lifecycle.md
quality-dashboard.md
architecture-fitness.md
tooling-landscape.md
governance/README.md
FB 状态机旧用 REJECTED/FIXED,治理层定义为 ACCEPTED。本 PR 后:
REJECTED
FIXED
ACCEPTED
治理层 6 文档 (含 governance/README) FB 归档 README │ │ │ 32 处引用 → │ │ │ │ ← 12 处反向引用 │ │ │ │ ↕ 7 处 LESSONS 反模式双向链接 ↕
rules/.archived/feedback/README.md │ §一 状态机唯一定义 │ §三 模板唯一规格 │ §四 索引(唯一事实表) │ §五 转化率唯一算法 ↑ │ 被引用 │ ┌─── governance 5 份治理文档 ────┐ │ retrospective-sop → 产出机制 │ │ delivery-lifecycle → 流程断点│ │ quality-dashboard → #18 指标 │ │ architecture-fitness → 技术债 │ │ tooling-landscape → 告警联动 │ └───────────────────────────────┘ │ │ 双向映射 ↓ LESSONS.md §二 反模式对照表
7 files changed, 194 insertions(+), 78 deletions(-)
核心 gain:
read_lints
本 PR 的所有新增引用都用相对路径(rules/.archived/feedback/README.md、governance/xxx.md),不绑定具体项目。迁移到新项目时目录结构不变即可直接生效。
governance/xxx.md
用户反馈
前一个 PR(#14)建立了治理层,但没有与已存在的
rules/.archived/feedback/FB 归档机制做连接。这导致:修复方案
1. 把 FB 归档 README 升级为治理层事实源
rules/.archived/feedback/README.md从 36 行扩到 123 行,包含 7 节完整规格:OPEN → RESOLVED / ACCEPTED2. retrospective-sop 去重
§4.3/4.4/4.5 不再重复 FB 模板 / 状态机 / 索引描述,统一改为"见
rules/.archived/feedback/README.md §X"。单一事实源原则。3. 其他 4 份治理文档与 FB 归档建立引用
delivery-lifecycle.mdquality-dashboard.mdarchitecture-fitness.mdtooling-landscape.mdgovernance/README.md4. 术语统一
FB 状态机旧用
REJECTED/FIXED,治理层定义为ACCEPTED。本 PR 后:OPEN → RESOLVED / ACCEPTED联合点核对结果
三层事实源结构
改动统计
核心 gain:
自举验证
read_lints0 错误抽象化判据
本 PR 的所有新增引用都用相对路径(
rules/.archived/feedback/README.md、governance/xxx.md),不绑定具体项目。迁移到新项目时目录结构不变即可直接生效。