cs-roadmap 启动必读 开始任何判断或动作前，先读取 ；缺失则视为骨架不完整，提示先补齐或运行 ，不要回退到外部 AI 入口文件。 是项目的"规划层"——每个子目录承载一块大需求，主文档由三块构成： 1. 概设 ：这块大需求要怎么搭、拆成哪几个模块 / 组件、各自职责 2. 架构层详设 ：模块之间的接口契约、共享数据结构、跨 feature 的协议 3. 子 feature 拆解 ：把方案分解成一串带依赖关系的子 feature 种子，feature 流程一次消费一条 三块 一起 作为这块大需求所有子 feature 的共同约束——每条子 feature 进 时，roadmap 第 2 块的接口契约就是它的 硬约束输入 （不能违反，要改先回 roadmap update）。 为什么 roadmap 承载架构方案不放进 ： 守"只记现状不记计划"。前瞻性架构方案属于"还没落地、可能还会变"的事前规划，放进 architecture 会污染那份系统地图。等子 feature 真正落地，对应接口由 提炼回 ——roadmap 完成过渡使命后归档。 为什么单独一层 ：requirements 记"要什么"（愿景）、architecture 记"怎么搭"（结构）、roadmap 记"怎么分步实现"（执行）。把执行规划塞进愿景或结构文档会把"要什么"和"打算怎么实现"混起来——查不到…