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

README.md

@@ -40,8 +40,8 @@ Playbook：工程规范与代理规则合集，当前覆盖：
 
 `templates/` 目录除了语言配置模板外，还包含 AI 代理工作环境的项目架构模板：
 
-- `templates/memory-bank/`：项目上下文文档模板（project-brief、tech-stack、architecture、progress、decisions）
-- `templates/prompts/`：工作流程模板（agent-behavior、clarify、review）
+- `templates/memory-bank/`：项目上下文文档模板（project-brief、tech-context、system-patterns、active-context、progress、decisions）
+- `templates/prompts/`：工作流入口模板（agent-behavior、clarify、verify-change、close-task、update-memory、code-review）
 - `templates/AGENTS.template.md`：路由中心模板（项目主入口）
 - `templates/AGENT_RULES.template.md`：执行流程模板
 
@@ -75,6 +75,26 @@ project_name = "MyProject"
 - **CLAUDE.md**：自动检测（根目录 → `.claude/`），不存在则创建；注入 `@AGENTS.md` / `@AGENT_RULES.md`
 - **force**：默认 false，已存在则跳过；设为 true 时强制覆盖（会先备份）
 
+### 工作流留痕 helper
+
+如果项目已经部署了这套模板，并使用 `superpowers` 工作流：
+
+```bash
+# spec 写完后
+python <deploy_root>/scripts/playbook.py \
+  -record-spec docs/superpowers/specs/<topic>-design.md \
+  -progress memory-bank/progress.md
+
+# plan 写完后
+python <deploy_root>/scripts/playbook.py \
+  -record-plan docs/superpowers/plans/<topic>.md \
+  -progress memory-bank/progress.md
+```
+
+这两个 helper 只负责把 `workflow-state` 写入
+`memory-bank/progress.md`。
+真正执行 Plan 仍然走 `main_loop.py claim/finish`。
+
 详见：`templates/README.md`
 
 ## rulesets/（规则集模板库 - 三层架构）
@@ -159,11 +179,11 @@ TSL 相关问题直接查阅 `rulesets/tsl/index.md` 与 `docs/tsl/`。
 
 ### 快速决策：我应该用哪种方式？
 
-| 你的情况 | 推荐方式 | 优势 |
-| --- | --- | --- |
-| 新项目，需要持续同步更新 | 方式一：`git subtree` | 标准留在项目内，后续可拉取更新 |
-| 不想把 Playbook 以 subtree 嵌进仓库，但仍要把标准部署到项目内 | 方式二：外部 clone 后执行部署 | Playbook 仓库与业务仓库解耦，部署根目录可配置 |
-| **不确定？** | **方式一：`git subtree`（推荐）** | 项目内可见、版本可追溯、使用路径最稳定 |
+| 你的情况                                                      | 推荐方式                          | 优势                                          |
+| ------------------------------------------------------------- | --------------------------------- | --------------------------------------------- |
+| 新项目，需要持续同步更新                                      | 方式一：`git subtree`             | 标准留在项目内，后续可拉取更新                |
+| 不想把 Playbook 以 subtree 嵌进仓库，但仍要把标准部署到项目内 | 方式二：外部 clone 后执行部署     | Playbook 仓库与业务仓库解耦，部署根目录可配置 |
+| **不确定？**                                                  | **方式一：`git subtree`（推荐）** | 项目内可见、版本可追溯、使用路径最稳定        |
 
 ---
 
@@ -251,7 +271,6 @@ git commit -m ":package: deps(playbook): add tsl standards"
    ```
 
 2. 在目标项目根创建 `playbook.toml`，并用 `deploy_root` 指定项目内的部署根。例如：
-
    - `project_root` 写目标项目根目录。
    - `deploy_root` 写目标项目内的相对路径。
    - 不要把外部 clone 的路径（如 `/opt/playbook`）写进 `deploy_root`；那只是你执行脚本的位置。