用途:在仓库内维护计划(plan)和规格(spec)文档的完整生命周期,防止陈旧文档被误当成当前事实。核心理念是文档所在目录即代表其状态:docs/specs/ 记录已发布功能的现实行为契约,docs/plans/ 代表正在构建或排队的意图,docs/archive/ 保存已发布计划的历史。功能流转为 propose → 实现 → verify → archive,init 每个仓库运行一次,decide 可在任意时点应用。
主要能力与用法:init 搭建目录结构,生成 docs/overview.md 并把约定块加入指令文件;propose 先访谈用户(分轮提问、每问附推荐答案),再一次性写出计划目录及规格变更文件;verify 只读报告,依次读计划与规格、结合上下文做代码审查、检查计划任务与规格场景、给出 Ready to archive 或 Not ready 结论;archive 固定按 merge、check、move 顺序,用 git mv 移动计划目录到带日期的归档目录;decide 生成 docs/decisions/NNNN-slug.md 记录跨功能技术决策,仅当难以逆转、缺乏上下文会令人困惑、存在真实权衡时才写。
文档契约:spec 用 Requirement: 与 Scenario: 描述可观察行为,不含内部实现;plan.md 含 Why、What changes、Out of scope、Design、Decisions、Risks、Open questions、Tasks;规格变更用 ADDED、MODIFIED、REMOVED 标记。
限制:verify 不修改任何文件;archive 前需已完成 verify,Not ready 时须用户逐条接受遗留问题;被放弃的计划目录直接删除而非归档;仓库指令文件中的 Docs conventions 块优先于默认路径。具体收费、平台限制等资料暂未提供。