jackin-brainstorm

jackin-brainstorm

通过与操作者开放式来回讨论，将现有路线图条目的意图（以及收集到的任何研究）转化为具体的设计决策，并逐步写入该条目的 ## Design 部分。

判断类任务——描述并做出决策；不要编写脚本、不要写代码，也不要将工作拆分为任务（这属于 plan，暂不处理）。

适用场景

• 操作者运行 jackin-brainstorm <slug>，为尚未关闭的路线图条目制定设计。

不适用场景

• 创建条目 → jackin-propose。
• 大规模外部调查或代码库调查 → jackin-research。
• 实现 → /goal Implement <slug>.md。

参数

• --research — 如果条目看起来内容不足，先运行 jackin-research。
• --resume — 从当前的 ## Design 状态继续。

流程

1. 加载上下文。 阅读 docs/content/docs/roadmap/<slug>.mdx 中的 Problem、Why It Matters、Design-so-far、Related Files，以及其中已链接的任何研究。
2. 自由讨论。 进行开放式来回讨论：提出备选方案、权衡和未决问题。将 jackin❯ 设计原则以及相关规则文件（ENGINEERING.md、HOST_AND_CONTAINER.md、TUI/文档规则）作为约束纳入考虑。优先一次只问一个问题；每部分确定后及时确认。
3. 逐步写入。 每个要点确定后，将相应内容（决策加上一句简短的原因）追加到或更新 .mdx 中匹配的 ## Design 部分。--resume 会从此处继续。
4. 遇到未知问题？ 快速调查（Explore/grep，或 deep-research）。大规模调查 → 单独建立一份 jackin-research 研究档案，并从 ## Design 链接到它。然后继续做决策。
5. 收敛。 当 ## Design 完整涵盖端到端方案时，进行总结，并指向实现步骤（/goal Implement <slug>.md）。
6. 提交并推送。 每个已确定的部分都按 docs: 提交（每次提交后推送）。

常见错误

• 编写代码或填写 ## Tasks —— 超出范围。
• 不经来回讨论就直接给出完整设计，或一次提出多个问题。
• 只在聊天中记录决策，而不写入 ## Design（必须能从中断处继续）。
• 复述规则文件的内容，而不是按名称引用。