Back to Workflow & Productivity

executing-plans

workflow managementproject executiontask managementdevelopment processcoding plansai assistant workflowcheckpointing
229.6k📄 MIT🕒 2026-06-16Source ↗

Install this skill

npx skills add obra/superpowers

Works 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

  1. User provides a structured plan file to the agent.
  2. Agent performs a critical review and confirms no blockers exist.
  3. Agent implements the first three tasks and runs required verifications.
  4. Agent stops, presents output, and requests human feedback.
  5. 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

What should I do if the agent identifies a gap in my plan?
You should refine the plan based on the agent's feedback before instructing it to start execution.
Why does the agent stop after every three tasks?
This batch size is a safety mechanism to ensure the agent remains aligned with your architectural goals and catches errors early.
Can I adjust the batch size?
The skill is configured to default to three tasks per batch to optimize for review frequency and error isolation.
What happens when all tasks are complete?
The agent automatically switches to the finishing-a-development-branch skill to wrap up the code changes and verify tests.

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.

Source & trust

230k stars📄 MIT🕒 Updated 2026-06-16
📄 Full skill instructions — original source: obra/superpowers
# Executing Plans

## 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)

  1. Click "Download" above
  2. In your project, create the directory: .agent/skills/executing-plans/
  3. Save the file as SKILL.md
  4. 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

Read the Master Guide: Mastering Agent Skills

Related Skill Units

Recommended Rules

View more rules

Recommended Workflows

View more workflows

Recommended MCP Servers

View more MCP servers

Take It Further

Maximize your productivity with these powerful resources

📋

Define Your Standards

Set up coding standards to ensure this workflow produces consistent, high-quality results.

Browse Rules Library
📖

Master Workflows

Learn how to create custom workflows, use Turbo Mode, and build your automation library.

Complete Guide

How to use this Skill in Claude Code & Cursor

For Claude Code (CLI)

To use this skill in Claude Code, copy the rule content into your project's custom instructions or follow our Add-Skill CLI guide. This ensures Claude follows your standards during every code generation.

For Cursor & Windsurf

For Cursor or Windsurf, individual skills are best used in the "Rules for AI" section. This specific unit helps the agent avoid workflow & productivity issues, leading to cleaner, more efficient code.

Why the skill format matters: the standardized Agent Skills format lets your AI agent load detailed instructions only when they are relevant, keeping your prompt clean while improving results.

Source & attribution

This skill is categorized under Workflow & Productivity and is published by Jesse Vincent, maintained in obra/superpowers.

← Browse All Agent Skills
Sponsored AI assistant. Recommendations may be paid.