用途:为代码与文档建立“同提交”纪律,是 claude-plugins 中 .claude/rules/docs-currency.md 的可复用版本,面向 blueprint 驱动项目。
主要能力:规定代码与其文档必须在同一提交中落地;研究结论在功能从 in_progress 推进前先提升到 docs/;值得记录的架构决策需在同一提交中新增或更新 ADR。同提交范围包括:公共 API/导出类型对应内联 docstring 与 docs/api/ 参考文档;文件格式规范对应 docs/format-spec/<name>.md(手写散文,非生成);错误枚举/协议码对应 docs/errors/<name>.md 或协议参考;里程碑/阶段状态对应功能追踪条目及 docs/PLAN.md;架构决策对应 docs/adrs/NNNN-<title>.md;新增 CLI 标志或子命令对应 README 与 docs/cli/ 页面。
使用方式:研究结论先放在 tmp/(被 gitignore),在依赖功能推进前移入 docs/ 的规范路径;若产生决策则提交 ADR;更新功能追踪条目的 evidence 字段;之后才把状态从 in_progress 改为 done。提交前自查:是否改变公共 API、文件格式、错误枚举或里程碑状态;同一提交是否触及对应 docs/ 文件;是否新增/更新 ADR;tmp/research/ 是否为空或有意保留;追踪条目 evidence 是否引用新 docs/ 路径。合并前检查 git log main..HEAD 与 find tmp -type f。
适用场景:提交 API/格式变更、将研究提升到 docs/、落地 ADR、推进追踪条目、评审指出文档缺失时。
限制:不适用于无外部表面变化的内部重构、不会发布的草稿、无分支权衡的实现细节、不跨阶段门的小任务、拼写或空白修改。sidecar(TODO.md、功能追踪 JSON)不是权威文档,读者移植、调试或上手所需信息应放在 docs/。相关技能包括 blueprint-curate-docs、blueprint-sync、feature-tracking。具体命令与安装方式暂未提供。