✨ feat(workflow): add superpowers planning and execution state tracking

templates/prompts/system/agent-behavior.template.md

@@ -1,61 +1,49 @@
-# 工作模式参考
+# 工作流入口
 
 <!--
-本文件定义三种工作模式，供 AI 根据任务类型选择。
-核心规则（安全红线、验证清单等）见 AGENT_RULES.md。
+本文件不重复定义核心规则；它只负责把任务路由到合适的工作流入口。
+安全红线、验证要求、主循环规则见 AGENT_RULES.md。
 -->
 
-## 模式 1: 探索模式（Explore）
+## 路由原则
 
-**目的**：理解代码库、分析问题、收集信息
+- 需求不明确：先看 `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
+```
 
-**适用场景**：
+## 说明
 
-- 理解某个模块的实现
-- 分析 bug 的根本原因
-- 评估功能实现的可行性
-
----
-
-## 模式 2: 开发模式（Develop）
-
-**目的**：实现功能、修复 bug、重构代码
-
-**行为**：
-
-- 先读取相关文件，理解现有逻辑
-- 进行精确修改
-- 修改后运行测试验证
-
-**适用场景**：
-
-- 实现新功能
-- 修复已知 bug
-- 优化性能
-
----
-
-## 模式 3: 调试模式（Debug）
-
-**目的**：诊断问题、对比差异、验证行为
-
-**行为**：
-
-- 收集相关日志和输出
-- 分析差异原因
-- 修复后重新验证
-
-**适用场景**：
-
-- 测试失败
-- 输出不符合预期
-- 性能问题诊断
+- `prompts/` 是入口，不是规则权威
+- 稳定约束写入 `memory-bank/` 或 `AGENT_RULES.local.md`
+- 执行留痕以 `memory-bank/progress.md` 的
+  `workflow-state` 与 `plan-status` 为准
 
 ---