agentleFS
Sign inStart free
autovantautovant/superpowers/skills/executing-plans/SKILL.md

executing-plans

Skill9 starsChanged 8 months agoMITView on GitHub

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

We split this skill into the rules it gives an agent

12 rules. 8 are common, 3 are distinctive, and 1 is very specific to this project.

  • 8

    Common

    Most of the 162 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Common:

    If concerns: Raise them with your human partner before starting

    line 21
  2. Distinctive:

    If no concerns: Create TodoWrite and proceed

    line 22
  3. Common:

    Follow each step exactly (plan has bite-sized steps)

    line 28
  4. Common:

    Run verifications as specified

    line 29
  5. Common:

    After all tasks complete and verified:

    line 34
  6. Very specific:

    REQUIRED SUB-SKILL: Use superpowers:finishing-a-development-branch

    line 36
  7. Distinctive:

    Follow that skill to verify tests, present options, execute choice

    line 37
  8. Common:

    Don't force through blockers: - stop and ask.

    line 55
  9. Common:

    Follow plan steps exactly

    line 59
  10. Common:

    Don't skip verifications

    line 60
  11. Common:

    Stop when blocked, don't guess

    line 62
  12. Distinctive:

    Never start implementation on main/master branch without explicit user consent

    line 63

“Common” is measured: kept by at least 6 in 10 of the 162 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Executing Plans

Overview

Load plan, review critically, execute all tasks, report when complete.

Announce at start: "I'm using the executing-plans skill to implement this plan."

Note: Tell your human partner that Superpowers works much better with access to subagents. The quality of its work will be significantly higher if run on a platform with subagent support (such as Claude Code or Codex). If subagents are available, use superpowers:subagent-driven-development instead of this skill.

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 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: 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 (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
  • 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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free