cs-feat-design

启动必读

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

这一阶段的产出是一份方案文件 {slug}-design.md，加上从中抽出的行动清单 {slug}-checklist.yaml，以及人审前的 {slug}-design-review.md。这些东西后面会被 implement / code review / QA / acceptance 消费，所以这里写错或写漏，下游就跟着错。

共享路径和命名约定看 .codestable/reference/shared-conventions.md。本阶段一般 feature 目录已经由 brainstorm 创建好了；没有的话在这一步建。 报告语言：design / plan 正文必须按 .codestable/attention.md 用中文；若草稿用了英文，落盘前先改写为中文。frontmatter / yaml 字段不翻译。

本阶段有三个入口：

• 正式起草：用户已经能讲清楚需求（或已经填好 {slug}-intent.md），直接进"流程"一节走完整起草。
• 初始化模式：用户说"开一个新需求 / 起个草稿 / 新建一个 feature"，但想自己先写半成品方案而不是口述。走下一节"初始化模式"，建好目录和空 {slug}-intent.md 就结束本轮，等用户填完再回来。
• 从 roadmap 条目起头：用户说"开始做 roadmap 里的 {子 feature slug}"或"推进 {roadmap} 的下一条"。slug 从 roadmap items.yaml 取，不另起；动笔前要读 roadmap 主文档和 items.yaml 了解上下文和依赖状态；落盘时 frontmatter 要带 roadmap / roadmap_item 两个字段，同时回写 items.yaml 把对应条目 status 改为 in-progress、feature 填为 feature 目录名。详见下文"从 roadmap 条目起头"。

设计原则：design 不是实现前的散文说明，而是后续实现和验收的可执行契约。它必须把"做好"翻译成可观察证据，把 steps 切成独立可验证单元，把风险和依赖前置暴露，并在交给用户前做一次自我批判，修掉含糊标准、混合步骤和薄弱依赖。