obra/superpowers@executing-plans

Use when you have a written implementation plan to execute in a separate session with review checkpoints

1,592 stars

Best use case

obra/superpowers@executing-plans is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Use when you have a written implementation plan to execute in a separate session with review checkpoints

Teams using obra/superpowers@executing-plans should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/superpowers-executing-plans/SKILL.md --create-dirs "https://raw.githubusercontent.com/openakita/openakita/main/skills/superpowers-executing-plans/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/superpowers-executing-plans/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How obra/superpowers@executing-plans Compares

Feature / Agentobra/superpowers@executing-plansStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Use when you have a written implementation plan to execute in a separate session with review checkpoints

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 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
- Never start implementation on main/master branch without explicit user consent

## Integration

**Required workflow skills:**
- **superpowers:using-git-worktrees** - REQUIRED: Set up isolated workspace before starting
- **superpowers:writing-plans** - Creates the plan this skill executes
- **superpowers:finishing-a-development-branch** - Complete development after all tasks

Related Skills

obra/superpowers@writing-skills

1592
from openakita/openakita

Use when creating new skills, editing existing skills, or verifying skills work before deployment

obra/superpowers@writing-plans

1592
from openakita/openakita

Use when you have a spec or requirements for a multi-step task, before touching code

obra/superpowers@using-superpowers

1592
from openakita/openakita

Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

obra/superpowers@verification-before-completion

1592
from openakita/openakita

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

obra/superpowers@test-driven-development

1592
from openakita/openakita

Use when implementing any feature or bugfix, before writing implementation code

obra/superpowers@subagent-driven-development

1592
from openakita/openakita

Use when executing implementation plans with independent tasks in the current session

obra/superpowers@requesting-code-review

1592
from openakita/openakita

Use when completing tasks, implementing major features, or before merging to verify work meets requirements

obra/superpowers@receiving-code-review

1592
from openakita/openakita

Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

obra/superpowers@using-git-worktrees

1592
from openakita/openakita

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

obra/superpowers@finishing-a-development-branch

1592
from openakita/openakita

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

obra/superpowers@dispatching-parallel-agents

1592
from openakita/openakita

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

obra/superpowers@systematic-debugging

1592
from openakita/openakita

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes