Skip to content

Latest commit

 

History

History
41 lines (36 loc) · 2.44 KB

File metadata and controls

41 lines (36 loc) · 2.44 KB

命名注册表(§14.1 命名单点注册)

全仓库工件文件名与状态词汇的单点定义。新增命名先改本表,再使用。 代码面唯一出处:src/constants.ts;本文件是仓库工件清单的注册视图。

状态词表(§3.3)

状态 语义 禁止别名
not_started 未开始 如 todo/new 等
in_progress 进行中(全局最多一个,WIP=1) 如 active/doing
blocked 阻塞(必须附 blocked_reason 与解除条件) 如 stuck
passing 仅由验证门置位(验证通过 + 证据落盘) 如 pass/done/complete(AP-07)

工件规范名(§8)

工件 规范名 允许别名
入口指令文件 AGENTS.md CLAUDE.md / agents.md
特性清单 feature_list.json feature-list.json / features.json
进度日志 PROGRESS.md progress.md / claude-progress.md
决策日志 DECISIONS.md docs/decisions/
交接文档 session-handoff.md
验证入口 scripts/check.sh make check / CI 等价物
清洁清单 clean-state-checklist.md clean-state-check
评估准则 evaluator-rubric.md
架构规则 .harness/arch-rules.json check-arch
命名注册表 naming-registry.md

规则

  1. 新增工件名/状态词:先改 src/constants.ts(代码面唯一出处),再同步本表。
  2. 指令、清单、脚本、CI 一律引用规范名;别名仅限兼容遗留且须在本表声明(§14.1)。
  3. 状态词禁止第二套(AP-07);文件名禁止多处异名引用(AP-08)。

形态 C 命名(D-016,服务化状态机)

命名 语义 备注
ctx.features 状态机服务:create/update/transition/verify + CAS 修订号 仿 harness goal/goal 模式
feature/change 状态变更会话事件(声明 ignorable: true 兼容 harness known-event-types 读路径
get_feature / update_feature / verify_feature 三工具(替代手改 feature_list.json) verify 跑 verification 步骤成功才提交
feature_dashboard 模型可见状态视图(C-3a:计数/WIP/证据摘要/投影一致性) 只读;GUI 看板暂缓(D-018)
corrupt 严格 fold 的判定结果(WIP=1 违约 / passing 无证据 / 非法跳转) 不是状态词(状态词表 §3.3 不变)
导出投影 feature_list.json 作为会话日志的导出视图(方案甲真源) 会话日志为真源,文件为投影