executing-plans
Install this skill
npx skills add obra/superpowersWorks across Claude Code, Cursor, Codex, Copilot & Antigravity
The executing-plans skill provides a structured framework for autonomous agents to convert complex development roadmaps into finished code. By enforcing a strict batch-processing methodology, the agent decomposes large objectives into three-task increments, requiring human verification at each transition point. This constraint forces the agent to pause for architect-level oversight, preventing silent errors or departures from the intended architectural path. Before initiating any action, the agent performs a mandatory critical audit of the provided plan to identify gaps, dependencies, or logical failures. If the plan holds up to scrutiny, the agent methodically iterates through implementation, verification, and reporting, ensuring that progress remains aligned with the human partner's expectations. This approach replaces unstructured coding with a rigorous, checkpoint-driven workflow that prioritizes transparency and verifiable output over rapid, opaque iteration.
When to Use This Skill
- •Implementing multi-part features that require architectural review between stages
- •Refactoring existing codebases where individual components need incremental testing
- •Executing complex migration scripts that require intermittent validation
- •Managing lengthy development branches where visibility into progress is essential
How to Invoke This Skill
Example prompts that trigger this skill in Claude Code, Cursor, or Antigravity:
- “I'm using the executing-plans skill to implement this plan.
- “Start executing the loaded plan using batch increments.
- “Begin the task sequence and report back after the first batch.
- “Follow the plan for this feature; check in every three tasks.
- “Initiate plan execution; pause for my approval between batches.
Pro Tips
- 💡Always clarify ambiguous plan steps with your human partner BEFORE execution to prevent rework.
- 💡Leverage the batch execution for complex tasks; smaller batches allow for quicker, more targeted feedback loops.
- 💡Integrate this skill with 'finishing-a-development-branch' for a seamless transition from execution to completion.
What this skill does
- •Critically audits task plans for logical gaps or blockers before initiation
- •Executes development tasks in verified three-step batches
- •Automates status reporting after each batch to keep human stakeholders informed
- •Coordinates with finishing-a-development-branch upon final task completion
- •Enforces mandatory verification steps for every individual task in the sequence
When not to use it
- ✕Tasks requiring immediate, high-velocity coding without human oversight
- ✕Simple one-off fixes that do not warrant a structured plan or batching
Example workflow
- User provides a structured plan file to the agent.
- Agent performs a critical review and confirms no blockers exist.
- Agent implements the first three tasks and runs required verifications.
- Agent stops, presents output, and requests human feedback.
- User approves; agent proceeds to the next batch or calls the finalization skill.
Prerequisites
- –A clearly defined task plan
- –Active human oversight for feedback loops
- –Access to the finishing-a-development-branch skill
Pitfalls & limitations
- !Forcing through tasks without stopping when a verification fails
- !Assuming the agent knows the project context without a formal plan
- !Failing to pause for feedback, which bypasses the core safety checkpoint
FAQ
How it compares
Unlike standard autonomous coding which often cascades errors until completion, this skill enforces pauses for human validation, significantly reducing the risk of divergent development paths.
📄 Full skill instructions — original source: obra/superpowers
## Overview
Load plan, review critically, execute tasks in batches, report for review between batches.
**Core principle:** Batch execution with checkpoints for architect review.
**Announce at start:** "I'm using the executing-plans skill to implement this plan."
## The Process
### Step 1: Load and Review Plan
1. Read plan file
2. Review critically - identify any questions or concerns about the plan
3. If concerns: Raise them with your human partner before starting
4. If no concerns: Create TodoWrite and proceed
### Step 2: Execute Batch
**Default: First 3 tasks**
For each task:
1. Mark as in_progress
2. Follow each step exactly (plan has bite-sized steps)
3. Run verifications as specified
4. Mark as completed
### Step 3: Report
When batch complete:
- Show what was implemented
- Show verification output
- Say: "Ready for feedback."
### Step 4: Continue
Based on feedback:
- Apply changes if needed
- Execute next batch
- Repeat until complete
### Step 5: Complete Development
After all tasks complete and verified:
- Announce: "I'm using the finishing-a-development-branch skill to complete this work."
- **REQUIRED SUB-SKILL:** Use superpowers:finishing-a-development-branch
- Follow that skill to verify tests, present options, execute choice
## When to Stop and Ask for Help
**STOP executing immediately when:**
- Hit a blocker mid-batch (missing dependency, test fails, instruction unclear)
- Plan has critical gaps preventing starting
- You don't understand an instruction
- Verification fails repeatedly
**Ask for clarification rather than guessing.**
## When to Revisit Earlier Steps
**Return to Review (Step 1) when:**
- Partner updates the plan based on your feedback
- Fundamental approach needs rethinking
**Don't force through blockers** - stop and ask.
## Remember
- Review plan critically first
- Follow plan steps exactly
- Don't skip verifications
- Reference skills when plan says to
- Between batches: just report and wait
- Stop when blocked, don't guess
How to Use This Skill Unit
Option A: Project-Specific (Recommended)
- Click "Download" above
- In your project, create the directory:
.agent/skills/executing-plans/ - Save the file as
SKILL.md - The agent will automatically discover the skill based on its description.
Option B: Global Installation (All Agents)
Save the file to these locations to make it available across all projects:
- Claude Code:
~/.claude/skills/obra/superpowers/executing-plans/SKILL.md - Cursor:
~/.cursor/skills/obra/superpowers/executing-plans/SKILL.md - Antigravity:
~/.gemini/antigravity/skills/obra/superpowers/executing-plans/SKILL.md
🚀 Install with CLI:npx skills add obra/superpowers
