文档 frontmatter status 词表
本仓库所有 .md 文档 frontmatter status: 字段取值必须取自本词表 3 个值之一。词表 owner 拍板于 2026-06-11,立法见 ADR-0003 frontmatter status 词表统一。
1. 词表(3 值)
| 值 | 语义 | 何时取该值 |
|---|---|---|
| active | canonical 且在用 | 已签字/已稳定/正在被引用且代表当前事实源的文档 |
| 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>/**(含 workstreamstatus.md、README.md、drafts/、reviews/,以及decisions/下的 workstream 级 ADR / MP——它们的status:表达文档生命周期,用本词表;已签字 =active,被 supersede =archived+ Replaced-by 指针)governance/decisions/README.md、governance/proposals/README.md等治理 meta 文档_archive/**(归档 README 与说明)
3. 不适用范围
下列文档有各自专属 status 状态机,不受本词表约束:
| 文档类型 | 专属 status 词表 | 出处 |
|---|---|---|
顶层治理 ADR(仅 governance/decisions/ADR-NNNN--*.md,四位序号双横线命名) | proposed / accepted / rejected / superseded / deprecated | decisions/README §"每份 ADR 最小 frontmatter" |
提案(governance/proposals/inbox/*.md 等) | open / accepted / rejected / superseded | change-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 / live | active | 同义合并 |
accepted / signed / complete(仍 canonical) | active | ADR/MP 已签 |
已确认 / 已确认(M0 最小版) | active | 中英混排清理 |
in-progress | active(仍持续)或 draft(未成 canonical) | case-by-case |
draft / 草稿 / pending / proposed / ready-to-dispatch | draft | 同义合并 + 中英混排清理 |
accepted-pending-research | draft | 待研究即未 canonical |
legacy | archived | legacy/ 目录下 |
superseded / deprecated-partial / deprecated | archived + Replaced-by: 文末指针 | 取代语义改用指针表达 |
complete(归档时) | archived | workstream 过程产物归档 |
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 文件)