# 工作流入口

<!--
本文件不重复定义核心规则；它只负责把任务路由到合适的工作流入口。
安全红线、验证要求、主循环规则见 AGENT_RULES.md。
-->

## 路由原则

- 需求不明确：先看 `docs/prompts/coding/clarify.md`
- 需要设计或拆解方案：走
  `using-superpowers` → `$brainstorming` → `$writing-plans`
- `brainstorming` 结束后：立即
  `playbook.py -record-spec <path> -progress memory-bank/progress.md`
- `writing-plans` 结束后：立即
  `playbook.py -record-plan <path> -progress memory-bank/progress.md`
- 需要执行已有 Plan：先 `main_loop.py claim`，再走
  `$executing-plans`
- 如为代码类执行：在 `$executing-plans` 前强制叠加
  `karpathy-guidelines`，并同时遵循 `.agents/` 与 `AGENT_RULES.md`
- 需要确认改动是否站得住：看 `docs/prompts/coding/verify-change.md`
- 一轮工作收尾：看 `docs/prompts/coding/close-task.md`
- 需要更新上下文：看 `docs/prompts/coding/update-memory.md`
- 需要评审 MR/PR：看 `docs/prompts/coding/code-review.md`

## 最小工作流

```text
需求不清 -> clarify
需求明确 -> using-superpowers / brainstorming / writing-plans
brainstorming 完成 -> record planning/spec
writing-plans 完成 -> record plan/executor/constraints
进入执行 -> claim -> executing-plans
代码执行 -> + karpathy-guidelines + .agents + AGENT_RULES
执行结束 -> finish -> update-memory
准备交付 -> verify-change
本轮结束 -> close-task
上下文变化 -> update-memory
```

## 说明

- `prompts/` 是入口，不是规则权威
- 稳定约束写入 `memory-bank/` 或 `AGENT_RULES.local.md`
- 执行留痕以 `memory-bank/progress.md` 的
  `workflow-state` 与 `plan-status` 为准

---

**最后更新**：{{DATE}}