| 文档 | 认知角色 | 内容概要 |
|---|---|---|
| ROADMAP.md | 方向 | 目标 + 行动列表，不承载状态回顾 |
| docs/index.md | 架构 | 场景—困境—救援—新生 |
| docs/brd/index.md | 业务 | 为什么做、业务场景、问题分析 |
| docs/prd/index.md | 需求 | 核心用户故事、验收标准 |
| docs/pmd/index.md | 管理 | 当前阶段、待验证方向 |
发布 Release 时，必须加载主仓库 devops-release Skill 并按工作流逐行执行，不可跳过预检查。子模块有独立 CHANGELOG（src/provider/CHANGELOG.md、src/studio/CHANGELOG.md），对应各自 tag（provider/v*、studio/v*），发布时分别检查。
写作云从叙事工程信息共享为起点，提供分析结果和风格积累；再逐渐向具体写作活动延伸，逐渐加入常见的写作工具。
产品层面：每次方向错位都是因为从实现路径倒推产品定位（"有分析能力了，做个改写界面吧"），而不是从用户困境倒推。
文档层面：同样的模式会转移到写文档上——AI 容易把"当前不做的选择"固化为"不可逾越的规则"，把优先级问题写成约束问题。应写成"从这里起步、往那里延伸"，而非"绝不做什么"。
ROADMAP 是减负工具——让人不需要问"接下来呢"。
作用：
- 完成一项就打勾，旧事自然翻篇
- 工作暂停后重启时，扫一眼就知道站在哪
- 不指挥做什么，但消除重新对齐上下文的成本
结构：
- 目标：一句话说明当前要验证什么
- 行动：checkbox 列表，每项动作用
—行内说明意图
与 PMD 的分工：PMD 承载"做过什么、待验证方向"，ROADMAP 不重复这些。