rogee/superpowers
1
0
Fork 0
mirror of https://github.com/obra/superpowers.git synced 2026-04-24 10:29:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

Add workflow checkpoints and scaling to SDD, refine handoffs

Browse Source 
- brainstorming: check in with user before transitioning to writing-plans
- writing-plans: structured execution handoff (record context, advise
  compaction, give exact continuation prompt with subagent detection)
- SDD: add scaling paragraph with GATE + orchestrator boundary, graphviz
  decision diamonds for review elision, check-in before finishing,
  replace TodoWrite with generic task list language, tighten Red Flags
This commit is contained in:
Jesse Vincent
2026-02-21 08:54:23 -08:00
parent 41512d6f3a
commit 7cefe7498c
3 changed files with 40 additions and 21 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
skills/writing-plans/SKILL.md
View File

@@ -166,15 +166,19 @@ After completing each chunk of the plan:
After saving the plan:
**"Plan complete and saved to `docs/superpowers/plans/<filename>.md`. Ready to execute?"**
**1. Record context.** Before anything else, verify all artifacts are saved and the plan is self-contained:
- Spec document path (if one was written)
- Plan document path
- Key architectural decisions, constraints, or user preferences that affect implementation but aren't captured in the plan — add them to the plan now
**Execution path depends on harness capabilities:**
**2. Advise compaction.** Execution works better with a fresh window. Tell the user:
**If harness has subagents (Claude Code, etc.):**
- **REQUIRED:** Use superpowers:subagent-driven-development
- Do NOT offer a choice - subagent-driven is the standard approach
- Fresh subagent per task + two-stage review
> "The plan is saved to `docs/superpowers/plans/<filename>.md`. Before we start implementation, I recommend compacting this session — execution works better with a fresh window."
**If harness does NOT have subagents:**
- Execute plan in current session using superpowers:executing-plans
- Batch execution with checkpoints for review
**3. Give exact continuation prompt.** Tell the user exactly what to say after compacting. Use the actual filename, not a placeholder.
If you can dispatch subagents (Claude Code, etc.):
> "After compacting, say: **Execute the plan at `docs/superpowers/plans/<filename>.md` using subagent-driven-development.**"
If you cannot dispatch subagents, ask the user: "The plan is ready. I can't dispatch subagents in this environment — should I execute the tasks in this thread?"