cs-roadmap

启动必读

开始任何判断或动作前，先执行 CodeStable preflight：读 .codestable/attention.md；缺失先 cs-onboard；不读外部 AI 入口替代（详见 .codestable/reference/execution-conventions.md）。

.codestable/roadmap/ 是项目的"规划层"——每个子目录承载一块大需求，主文档由三块构成：

概设：这块大需求要怎么搭、拆成哪几个模块 / 组件、各自职责
架构层详设：模块之间的接口契约、共享数据结构、跨 feature 的协议
子 feature 拆解：把方案分解成一串带依赖关系的子 feature 种子，feature 流程一次消费一条

三块一起作为这块大需求所有子 feature 的共同约束——每条子 feature 进 cs-feat-design 时，roadmap 第 2 块的接口契约就是它的硬约束输入（不能违反，要改先回 roadmap update）。

当 roadmap 涉及跨模块 module interface、seam、adapter 或依赖替身策略时，按 references/codebase-design.md 做内嵌 deep-module 检查；这不是切换到独立 codebase-design skill。

为什么 roadmap 不直接写 ADR：ADR（requirements/adrs/）记的是"已经拍板的稳定结构性决策"，roadmap 记的是"还没落地、可能还会变"的前瞻性接口契约。等子 feature 真正落地、对应接口稳定后，由 cs-feat-accept 盘点出来的领域影响触发 cs-domain 写 ADR——roadmap 完成过渡使命后归档。

为什么单独一层：requirements 记"要什么 + 怎么定义术语 + 拍板了哪些决策"（愿景 + 领域），roadmap 记"怎么分步实现"（执行）。把执行规划塞进 requirements 会把"要什么"和"打算怎么实现"混起来。