🔧 chore(playbook): align repo with latest workflow

sync playbook-managed rules and prompts.
migrate memory-bank to the new structure and move plans to docs/superpowers/plans.
keep product README files untouched.

docs/prompts/README.md

@@ -1,6 +1,6 @@
-# 提示词库
+# 提示词入口
 
-本目录包含 AI 代理的工作流程参考模板。
+本目录包含 AI 代理的工作流入口模板，用于把任务路由到合适的执行路径。
 
 ## 目录结构
 
@@ -8,41 +8,68 @@
 prompts/
 ├── README.md              # 本文件
 ├── system/
-│   └── agent-behavior.md  # 工作模式参考
+│   └── agent-behavior.md  # 工作流入口
 ├── coding/
 │   ├── clarify.md         # 需求澄清模板
-│   └── review.md          # 复盘总结模板
-└── meta/
-    └── prompt-generator.md # 元提示词生成器
+│   ├── verify-change.md   # 变更验证模板
+│   ├── close-task.md      # 本轮收尾模板
+│   ├── update-memory.md   # 回写记忆模板
+│   └── code-review.md     # MR/PR 代码评审流程
+└── custom/                # 可选：项目私有提示词
 ```
 
 ## 使用方式
 
-| 模板                    | 触发场景                       |
-| ----------------------- | ------------------------------ |
-| **agent-behavior.md**   | 切换工作模式（探索/开发/调试） |
-| **clarify.md**          | 需求不明确时澄清               |
-| **review.md**           | Plan 完成后复盘总结            |
-| **prompt-generator.md** | 创建新的专用提示词             |
+| 模板                  | 触发场景             |
+| --------------------- | -------------------- |
+| **agent-behavior.md** | 选择工作流入口       |
+| **clarify.md**        | 需求不明确时澄清     |
+| **verify-change.md**  | 声称完成前做验证     |
+| **close-task.md**     | 本轮工作收尾         |
+| **update-memory.md**  | 上下文变化后回写记忆 |
+| **code-review.md**    | 执行 MR/PR 代码评审  |
+| **custom/*.md**       | 项目私有补充流程     |
 
 ## 工作流程
 
-```
+```text
 需求不清 → clarify.md
     ↓
-头脑风暴 → $brainstorming skill
+入口约束 → using-superpowers
     ↓
-生成计划 → $writing-plans skill → docs/plans/*.md
+头脑风暴 → $brainstorming skill → docs/superpowers/specs/*-design.md
     ↓
-执行计划 → AGENT_RULES 主循环（留痕）
+spec 完成后 → `playbook.py -record-spec <path> -progress memory-bank/progress.md`
     ↓
-完成复盘 → review.md
+生成计划 → $writing-plans skill → docs/superpowers/plans/*.md
     ↓
-沉淀提示词 → prompt-generator.md（可选）
+plan 完成后 → `playbook.py -record-plan <path> -progress memory-bank/progress.md`
+    ↓
+领取计划 → `main_loop.py claim`
+    ↓
+执行计划 → `$executing-plans`
+    ↓
+代码类任务 → `karpathy-guidelines` + `.agents/` + `AGENT_RULES.md`
+    ↓
+写回状态 → `main_loop.py finish`
+    ↓
+更新摘要 → update-memory.md
+    ↓
+验证改动 → verify-change.md
+    ↓
+本轮收尾 → close-task.md
+    ↓
+代码评审（有 MR/PR 时）→ code-review.md
 ```
 
-> **核心规则在 `AGENT_RULES.md`**，第三方 skills 负责规划，主循环负责执行和留痕。
+> `coding/` 下是可被框架覆盖更新的标准模板；
+> 项目私有流程应沉淀到 `custom/`。
+>
+> `prompts/` 是入口层；核心规则在 `AGENT_RULES.md`，
+> 长期记忆在 `memory-bank/`，状态留痕必须走
+> `playbook.py -record-spec/-record-plan` 与
+> `main_loop.py claim/finish`。
 
 ---
 
-**最后更新**：2026-02-03
+**最后更新**：2026-05-24