跳到主要内容

Governance Templates

状态：Active / 治理库公共模板目录 最后更新：2026-05-15 用途：Admin 提供给 Project Controllers 复用的产物模板（不替写项目正文，遵守 FR-010 / Controller-owned 边界）

1. 目的​

本目录是 Admin 在 FR-010（Admin / Controller 边界）约束下提供的模板与种子。Admin 可以提供：

  • 必备字段清单（让 Controllers 知道一份合格的项目正文应包含什么）
  • 工程化产出种子范例（让 Controllers 知道一份合格的 schema / sample / prompt / eval 长什么样）
  • 文档结构模板（让 Controllers 不必从零起步）

但 Admin 不：

  • 替写项目正文（projects/<project>/ 下的 canonical 文档）
  • 替写项目 schema / sample / prompt / eval 的具体业务内容
  • 越过 Controller 自行决定项目优先级或时间线

2. 当前模板​

文件适用对象触发根因
project-canonical-required-fields.md各项目 Controller 写或重写 projects/<project>/{strategic-whitepaper,product-definition,mvp-product-definition}.md 时FR-014 / FR-015 / FR-017 三方一致 P0 未解决
reader-surface-cleanup-sop.md任何 canonical / support 类正文文档"首屏 30 行"清洗FR-011 (叙事被 process metadata 污染) + Codex Reader Audit P1

3. 复用规则​

  • 模板强烈推荐但不强制：Controller 有其特殊场景的可调整，但需在 sync packet 中说明偏离理由
  • 模板字段应全部回答：不能用 "TBD" 或 "待补充" 作为最终值，必须给具体内容或显式标 "本项目不适用 + 理由"
  • 模板使用证据应在 PR 描述中引用本目录路径

4. 与现有 governance 的关系​

  • 与 document-change-scope-policy.md §10：项目正文回写时使用本模板可作为 "doc alignment" 证据之一，但仍需独立 reader testing 才能升级到 "project progress" 或 "publish evidence"
  • 与 reader-testing-protocol.md：模板使用后必须按等级表跑 reader testing

5. 不在本目录范围​

  • 工程仓库的 schema 模板（应在工程仓库 schemas/ 或 types/ 下，本目录只放 governance-side 模板）
  • evaluation case YAML（应在 evaluation/<project>/cases/ 下，本目录只放 schema 描述）
  • prompt template（应在工程仓库或 evaluation/<project>/prompts/ 下，本目录只放 schema 描述）

6. 后续模板候选​

按 Controller 实际使用反馈再补：

  • 项目 README 模板（FR-003 / FR-004）
  • Controller state.md 模板（已有事实但未抽象）
  • closeout sync packet 模板（已在 packets/sync/README.md §6 + §11.A）
  • changelog / 演化记录 末尾块模板（reader-surface-cleanup SOP 的配套，第 2 次复用后再抽）