Squashed 'docs/standards/playbook/' changes from c3f8137..25d895d

25d895d 🐛 fix(gitea_workflow): clean up temp repos after job steps
2bc3b11 🐛 fix(gitea_workflow): clean up temporary repo dirs in workflows
98c3f30 📝 docs(agent_rules): allow plan execution on current branch
16c7230 📝 docs(prompts): define custom verify layering
8efc4dd 🐛 fix(skills): quote commit-message description
bc8498f 🐛 fix(ci): install tomli for gitea tests
55cda3b 🐛 fix(tests): report missing toml parser clearly
c0729c7 🐛 fix(playbook): import Optional for cli compatibility
63e24bf 📦 deps(skills): sync thirdparty skills
d2f9356 🐛 fix(ci): isolate gitea workflow repos
588b81d 🐛 fix(ci): inline gitea workflow bootstrap
e0b1c3a ♻️ refactor(skills): standardize first-party skill contracts
2c5050d ♻️ refactor(skills): rename repo skills source dir
f049dfb 📦 deps(skills): drop duplicate first-party superpowers skills
234b335 ✨ feat(workflow): add superpowers planning and execution state tracking
c1702a6 📝 docs(markdown): format tracked markdown and drop stale templates
2325409 📝 docs(markdown): clarify optional markdownlint usage
214c44e 🔧 chore(markdown): add markdownlint baseline and lint fixes
a22b324 📝 docs(templates): add execution and memory-bank prompt templates
223a797 📝 docs(templates): update README for Claude Code and current features
4ac8672 📝 docs: simplify README + platform-agnostic tools + auto-create local rules
2431c9d 📝 docs: add claude_md config and use cross-platform paths
d64b248 📝 docs: fix README.md inaccuracies and add Claude Code info
c8d6bf2 🐛 fix(playbook): use relative paths in CLAUDE.md when not at project root
6518f0f ✨ feat(playbook): auto-create CLAUDE.md with path discovery
6ec9a45 ✨ feat(skills): add skill_link symlink support + platform-agnostic prompt
9f8b6b5 📝 docs: update README and config example for Claude Code support
79cff6c 📝 docs(skills): add Claude Code platform support
452c6f5 ✨ feat(playbook): auto-inject AGENTS.md into CLAUDE.md
e1dbf3c 🐛 fix(skills): remove dual-path from commit-message skill
f3a7259 🔧 chore(ci): use prepare_repo.sh in both workflows
da08212 🔧 chore(ci): extract prepare_repo.sh and clean up workflows
7ade85e 🗑️ remove(tsl): drop syntax_book/, data/ source and build script
f94dba0 ♻️ refactor(skills): update playbook.py and tests for thirdparty/ layout
b3df412 ♻️ refactor(skills): separate thirdparty skills into thirdparty/ subdirectory
64950e7 📦 deps(skills): sync thirdparty skills
a2e3cb0 ✨ feat(playbook): add no_backup deploy controls
8609d59 🐛 fix(docs): repair reference catalog source links
956da11 🐛 fix(playbook): publish hidden ci test fixes
3f67754 📦 deps(skills): sync thirdparty skills
08ca87b 📦 deps(skills): add karpathy thirdparty sync
96b705b 📝 docs(tsl): rebuild canonical syntax and routing manual
3ed5052 📦 deps(skills): sync thirdparty skills
60108dd 📦 deps(skills): sync thirdparty skills
da85d4e 🐛 fix(thirdparty): prune nested project snapshots
a2a697e 📦 deps(skills): sync thirdparty skills
9df610a 🐛 fix(thirdparty): exclude duplicated superpowers skills
33dd5bb 🐛 fix(thirdparty): preserve optional manifest fields
91b0ea7 🐛 fix(thirdparty): preserve manifest during snapshot update
2e26f98 🔧 chore(thirdparty): generalize skills sync pipeline
5b9c1e3 📦 deps(skills): sync superpowers
2f2d34a 📝 docs(readme): normalize subtree command spacing
62db7db 🐛 fix(ci): serialize superpowers update and sync
3463223 🐛 fix(ci): use literal superpowers sync paths
48f6de8 📦 deps(skills): sync superpowers
4b23529 🔧 chore(ci): merge superpowers update and sync workflow
a56d75b 📦 deps(skills): sync superpowers
84bcefa 🔧 chore(ci): use ci[bot] commit author name
00a07e5 📦 deps(skills): sync superpowers
7b84daf 🐛 fix(templates): enforce main loop progress tracking
51373d7 🔧 chore(ci): automate superpowers sync workflow
eaaa39c 🐛 fix(ci): prevent stale superpowers sync from restoring skills block
79755c6 📦 deps(skills): sync superpowers
836d878 📦 deps(skills): sync superpowers
8216c9f 📦 deps(skills): sync superpowers
9439505 🐛 fix(playbook): address reported repo issues

git-subtree-dir: docs/standards/playbook
git-subtree-split: 25d895d8b3f56624ccfe99ad7289e9eb49e0f316

templates/memory-bank/active-context.template.md

@@ -0,0 +1,48 @@
+# 当前上下文
+
+<!--
+填写指南：
+- 本文件记录高频变化的上下文，供 AI 在跨 Session 时快速恢复工作状态
+- 保持简洁，只写“现在仍然重要”的信息
+- 任务完成或方向切换后及时更新
+-->
+
+## Current Goal
+
+<!-- 当前最重要的目标；一句话即可 -->
+
+- {{CURRENT_GOAL}}
+
+## Recent Changes
+
+<!-- 最近完成且会影响后续判断的变更 -->
+
+- {{RECENT_CHANGE_1}}
+
+## Touched Files
+
+<!-- 最近修改或正在关注的关键文件 -->
+
+- `{{FILE_1}}` - {{FILE_1_REASON}}
+
+## Open Questions
+
+<!-- 尚未确认、但会影响实现或验证的事项 -->
+
+- {{QUESTION_1}}
+
+## Next Steps
+
+<!-- 接下来最优先的 1-3 步 -->
+
+1. {{NEXT_STEP_1}}
+
+## Session Notes
+
+<!-- 只记录本轮最容易忘的上下文 -->
+
+- {{SESSION_NOTE_1}}
+
+---
+
+**最后更新**：{{DATE}}

templates/memory-bank/architecture.template.md

@@ -1,44 +0,0 @@
-# 架构设计
-
-<!--
-填写指南：
-- 【必填】：项目启动前必须填写
-- 【可选】：按需填写，可随项目发展补充
-- 小项目可只填核心模块，架构图可后补
--->
-
-## 整体架构
-
-<!-- 【可选】项目成熟后补充 -->
-
-```txt
-{{ARCHITECTURE_DIAGRAM}}
-```
-
-## 核心模块
-
-<!-- 【必填】至少列出主要模块 -->
-
-### {{MODULE_1}}
-
-**职责**：{{MODULE_1_DESC}}
-
-## 关键约束
-
-<!-- 【可选】 -->
-
-- {{CONSTRAINT_1}}
-
-## 扩展点
-
-<!-- 【可选】大项目建议填写 -->
-
-### {{EXTENSION_1}}
-
-**步骤**：
-
-1. {{STEP_1}}
-
----
-
-**最后更新**：{{DATE}}

templates/memory-bank/progress.template.md

@@ -1,4 +1,54 @@
-# Plan 状态
+# 当前进展
+
+<!--
+填写指南：
+- 上半部分给人类和 AI 快速恢复上下文
+- 中间的 workflow-state 块记录当前阶段、spec、plan 与执行约束
+- 下半部分的 plan-status 块由 main_loop.py 维护，是唯一权威状态源
+-->
+
+## Current Focus
+
+- {{CURRENT_FOCUS}}
+
+## Recent Changes
+
+- {{RECENT_CHANGE_1}}
+
+## Next Steps
+
+1. {{NEXT_STEP_1}}
+
+## Open Risks
+
+- {{RISK_1}}
+
+## 状态块示例
+
+以下示例仅用于说明结构，真实状态由 `main_loop.py` 维护：
+
+```text
+## Workflow State
+<!-- workflow-state:start -->
+phase: planning
+spec: docs/superpowers/specs/2026-05-18-demo-design.md
+plan: docs/superpowers/plans/2026-05-18-demo.md
+executor: executing-plans
+constraints: karpathy-guidelines,.agents,AGENT_RULES
+<!-- workflow-state:end -->
+
+## Plan Status
+<!-- plan-status:start -->
+- [ ] `2026-05-18-demo.md` pending
+<!-- plan-status:end -->
+```
+
+## Workflow State
+
+<!-- workflow-state:start -->
+<!-- workflow-state:end -->
+
+## Plan Status
 
 <!-- plan-status:start -->
 <!-- plan-status:end -->

templates/memory-bank/system-patterns.template.md

@@ -0,0 +1,60 @@
+# 系统模式与约束
+
+<!--
+填写指南：
+- 本文件记录跨模块稳定成立的实现模式，而不是一次性的设计草图
+- 优先记录：模块边界、数据流、不变量、扩展路径、禁止破坏的约束
+- 小项目可只保留最关键的 2-3 个部分
+-->
+
+## 模块边界
+
+<!-- 至少列出主要模块及其职责边界 -->
+
+### {{MODULE_1}}
+
+- **职责**：{{MODULE_1_DESC}}
+- **输入**：{{MODULE_1_INPUT}}
+- **输出**：{{MODULE_1_OUTPUT}}
+- **不应负责**：{{MODULE_1_NON_GOAL}}
+
+## 关键数据流
+
+<!-- 描述系统中的主路径；按“输入 -> 处理 -> 输出”写 -->
+
+1. {{FLOW_STEP_1}}
+2. {{FLOW_STEP_2}}
+3. {{FLOW_STEP_3}}
+
+## 核心不变量
+
+<!-- 这些约束一旦被破坏，系统行为就可能失真 -->
+
+- {{INVARIANT_1}}
+
+## 常见实现模式
+
+<!-- 给 AI 明确“这里通常怎么改” -->
+
+### {{PATTERN_1}}
+
+- **适用场景**：{{PATTERN_1_SCENARIO}}
+- **推荐做法**：{{PATTERN_1_APPROACH}}
+- **避免事项**：{{PATTERN_1_AVOID}}
+
+## 扩展路径
+
+<!-- 新增功能时，优先走哪些入口或目录 -->
+
+1. {{EXTENSION_STEP_1}}
+2. {{EXTENSION_STEP_2}}
+
+## 禁止破坏的约束
+
+<!-- 记录兼容性、安全性或组织层面的硬约束 -->
+
+- {{DO_NOT_BREAK_1}}
+
+---
+
+**最后更新**：{{DATE}}

templates/memory-bank/tech-context.template.md

@@ -0,0 +1,72 @@
+# 技术上下文与工具链
+
+<!--
+填写指南：
+- 本文件记录“如何在这个仓库里安全工作”
+- 优先填写命令、环境、入口路径、依赖限制
+- 未填写的占位符保持原样或删除整行
+-->
+
+## 核心技术
+
+<!-- 【必填】项目主要语言、框架、运行时 -->
+
+- {{TECH_1}}
+
+## 项目结构
+
+<!-- 【必填】至少列出关键目录 -->
+
+```text
+{{PROJECT_NAME}}/
+├── {{DIR_1}}/           # {{DIR_1_DESC}}
+└── memory-bank/         # 项目上下文
+```
+
+## 关键入口
+
+<!-- 【必填】AI 最常用的入口文件、命令或目录 -->
+
+- `{{ENTRY_PATH_1}}` - {{ENTRY_PATH_1_DESC}}
+
+## 开发环境
+
+<!-- 【必填】至少填写验证相关命令 -->
+
+**必需工具**：
+
+- {{TOOL_1}}
+
+**运行测试**：
+
+```bash
+{{TEST_CMD}}
+```
+
+**格式化 / Lint**：
+
+```bash
+{{FORMAT_OR_LINT_CMD}}
+```
+
+## 环境与平台差异
+
+<!-- 【可选】如 Windows/Linux/macOS 行为不同，写在这里 -->
+
+- {{ENV_DIFF_1}}
+
+## 依赖与限制
+
+<!-- 【可选】外部服务、私有依赖、危险命令、慢命令 -->
+
+- {{DEPENDENCY_OR_LIMIT_1}}
+
+## 验证约定
+
+<!-- 【可选】什么叫“验证通过” -->
+
+- {{PASS_CONDITION_1}}
+
+---
+
+**最后更新**：{{DATE}}

templates/memory-bank/tech-stack.template.md

@@ -1,64 +0,0 @@
-# 技术栈与工具链
-
-<!--
-填写指南：
-- 【必填】：项目启动前必须填写
-- 【可选】：按需填写，可随项目发展补充
-- 未填写的占位符保持原样或删除整行
--->
-
-## 核心技术
-
-<!-- 【必填】 -->
-
-**主语言**：{{MAIN_LANGUAGE}}
-
-**文件类型**：{{FILE_TYPES}}
-
-## 项目结构
-
-<!-- 【必填】 -->
-
-```text
-{{PROJECT_NAME}}/
-├── {{DIR_1}}/           # {{DIR_1_DESC}}
-└── memory-bank/         # 项目上下文
-```
-
-## 开发环境
-
-<!-- 【必填】至少填写运行测试命令 -->
-
-**必需工具**：
-
-- {{TOOL_1}}
-
-**运行测试**：
-
-```bash
-{{TEST_CMD}}
-```
-
-## 依赖管理
-
-<!-- 【可选】 -->
-
-**外部依赖**：
-
-- {{EXTERNAL_DEP_1}}
-
-## 测试策略
-
-<!-- 【可选】大项目建议填写 -->
-
-**测试类型**：
-
-- {{TEST_TYPE_1}}
-
-**验证标准**：
-
-- {{PASS_CONDITION_1}}
-
----
-
-**最后更新**：{{DATE}}