zj-roadmap-driven — 路线图驱动开发

目标： 在复杂任务场景中，用路线图（树形节点 + 决策记录）作为 Agent 和 Human 的共享心智模型。避免持续对话导致的目标偏离——每一步都在地图上留下足迹。

核心原则：

1. 存储载体决定事实源——普通路线图使用单 JSON；大型路线图显式使用 roadmap bundle，由 manifest、节点/决策 shards 和 append-only history 共同构成事实源。Agent 必须通过 CLI 读写，禁止直接编辑这些文件。
2. Markdown 是轻量渐进式视图——只暴露树形概览（depth=2）+ 当前施工焦点。Human 一眼看清进度，不占满上下文；Markdown 永远不能反向导入事实源。
3. 每个节点有编号（1, 1-1, 1-1-1, …），方便 Human 和 Agent 快速定位
4. 每个节点有状态 checkbox（[ ] / [~] / [x] / [!]），一眼识别进度
5. 决策随节点落盘（JSON 中），形成可追溯的决策历史。md 只展示焦点节点的决策。

工作流