跳到主要内容

文档 frontmatter status 词表

本仓库所有 .md 文档 frontmatter status: 字段取值必须取自本词表 3 个值之一。词表 owner 拍板于 2026-06-11,立法见 ADR-0003 frontmatter status 词表统一

1. 词表(3 值)

语义何时取该值
activecanonical 且在用已签字/已稳定/正在被引用且代表当前事实源的文档
draft工作中,未成为 canonical草拟、待评审、阶段未签字、待补研究
archived不再活跃已被取代(用 Replaced-by 指针)、退役至 legacy/、物理迁至 _archive/、workstream 收尾后的过程产物

"被取代"语义不再有独立 status 值。被取代时 status 改为 archived,并在文末显式写:

Replaced-by: <canonical-path-or-ADR>

替代指针约定自 变更协议 §5

2. 适用范围

适用于所有人写的 .md 文档 frontmatter status: 字段,包括:

  • projects/<id>/**
  • ecosystem/**
  • commons/**
  • governance/workstreams/<name>/**(含 workstream status.mdREADME.md、drafts/、reviews/,以及 decisions/ 下的 workstream 级 ADR / MP——它们的 status: 表达文档生命周期,用本词表;已签字 = active,被 supersede = archived + Replaced-by 指针)
  • governance/decisions/README.mdgovernance/proposals/README.md 等治理 meta 文档
  • _archive/**(归档 README 与说明)

3. 不适用范围

下列文档有各自专属 status 状态机,不受本词表约束:

文档类型专属 status 词表出处
顶层治理 ADR(仅 governance/decisions/ADR-NNNN--*.md,四位序号双横线命名)proposed / accepted / rejected / superseded / deprecateddecisions/README §"每份 ADR 最小 frontmatter"
提案(governance/proposals/inbox/*.md 等)open / accepted / rejected / supersededchange-protocol §6.1

豁免仅限上表两类governance/workstreams/*/decisions/ 下的 workstream 级 ADR 不豁免,用本词表(见 §2);尚未迁移的 workstream ADR(如 data-horizon 各 workstream)按 ADR-0003 §6 在其下次 cleanup 时对齐。

理由:ADR/提案的 status 表达"流程状态机位置",与"文档生命周期"是两套语义,不能合并。如果同一 ADR 文件同时需要表达流程状态(accepted)与文档生命周期(archived),用 ADR 自己的 status: 表达流程,文档生命周期通过物理位置(_archive/ vs 原位 + Replaced-by)表达,不再额外字段化。

4. 19 → 3 值迁移映射(已在 2026-06-11 W3/W6 批量执行)

历史值迁移至备注
active / stable / working / liveactive同义合并
accepted / signed / complete(仍 canonical)activeADR/MP 已签
已确认 / 已确认(M0 最小版)active中英混排清理
in-progressactive(仍持续)或 draft(未成 canonical)case-by-case
draft / 草稿 / pending / proposed / ready-to-dispatchdraft同义合并 + 中英混排清理
accepted-pending-researchdraft待研究即未 canonical
legacyarchivedlegacy/ 目录下
superseded / deprecated-partial / deprecatedarchived + Replaced-by: 文末指针取代语义改用指针表达
complete(归档时)archivedworkstream 过程产物归档

5. 新文档约束

写新 .md 时 status 字段必须取 active / draft / archived 三者之一。其他值由 verify:kb 拒绝(规则落地见 ADR-0003 §结果)。

6. 关联

  • 立法 ADR:ADR-0003 frontmatter status 词表统一
  • 弃用与归档流程:变更协议 §5
  • frontmatter 5 必填字段(含 status):仓根 CLAUDE.md §"99% 的情况:你只在改 Markdown" 与 项目正文必备字段
  • 2026-06-11 全仓批量迁移记录:FinBayes 项目目录下 .cleanup-status.md §2026-06-11 重组 cleanup(仓库直接访问者可见;公开站不渲染 dot-prefix 文件)