Use when you have a written implementation plan to execute in a separate session with review checkpoints
git clone https://github.com/obra/superpowers.git--- name: executing-plans description: Use when you have a written implementation plan to execute in a separate session with review checkpoints --- # 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 (Claude Code, Codex CLI, Codex App, Copilot CLI, and Gemini CLI all qualify; see the per-platform tool refs in `../using-superpowers/references/`). If subagents are available, use superpowers:subagent-driven-development instead of this skill. ## The Process ### Step 1: Load and Review Plan 1. Ensure an isolated workspace: use superpowers:using-git-worktrees to create one or verify the existing one 2. Read plan file 3. Review critically - identify any questions or concerns about the plan 4. If concerns: Raise them with your human partner before starting 5. If no concerns: Create todos for the plan items 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
[{"step":1,"action":"Prepare your implementation plan in a structured format (e.g., numbered steps with clear actions, expected outcomes, and success criteria).","tip":"Use bullet points or a table to organize steps for clarity. Include placeholders like [DATABASE_NAME] for dynamic inputs."},{"step":2,"action":"Paste the prompt template into your AI tool, replacing [PLAN] with your detailed implementation plan.","tip":"Ensure the plan includes review checkpoints after each step to pause for feedback."},{"step":3,"action":"Review the AI’s breakdown of each step. Confirm or adjust the action, expected outcome, success criteria, or potential blockers before proceeding.","tip":"If a step seems risky, ask the AI to suggest a safer alternative or a rollback plan."},{"step":4,"action":"Execute the step manually or via tools (e.g., database commands, APIs) as directed by the AI. Share the results or any errors for review.","tip":"Use tools like `pg_dump`, `curl`, or cloud dashboards to gather concrete data for validation."},{"step":5,"action":"After completing all steps, ask the AI to summarize progress, highlight risks, and recommend next actions (e.g., testing, documentation, or additional migrations).","tip":"Store the final summary in your project documentation for future reference."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/obra/superpowers/tree/main/skills/executing-plansCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Execute the following implementation plan step-by-step, pausing after each step to review progress with me: [PLAN]. For each step, provide: 1) the action to take, 2) expected outcome, 3) success criteria, and 4) potential blockers. After completing all steps, summarize the overall progress and suggest next actions. Ask for confirmation before proceeding to the next step.
Let’s execute the plan to migrate our customer database to a new cloud provider. Here’s how we’ll proceed: **Step 1: Backup Current Database** - Action: Run a full backup of the production database using PostgreSQL’s `pg_dump` command. - Expected Outcome: A complete snapshot of the database saved to `/backups/pre_migration_20240515.sql`. - Success Criteria: Backup file size matches the live database (~12.5GB) and passes integrity checks. - Potential Blockers: Insufficient storage on the backup server or network latency slowing the transfer. *Do you confirm we should proceed with this step?* **Step 2: Set Up Cloud Infrastructure** *(After Step 1 is confirmed and completed)* - Action: Deploy a new PostgreSQL instance on AWS RDS with the same schema and initial data load. - Expected Outcome: A functional cloud database with 99.9% uptime SLA and encryption enabled. - Success Criteria: Database is accessible via `psql -h [RDS_ENDPOINT]` and responds to queries within 200ms. - Potential Blockers: Misconfigured security groups or IAM permissions preventing access. *Shall we move to this step?* **Step 3: Data Migration** *(After Step 2 is confirmed)* - Action: Restore the backup to the new cloud database using `psql -f /backups/pre_migration_20240515.sql -h [RDS_ENDPOINT]`. - Expected Outcome: All tables, indexes, and data migrated with zero corruption. - Success Criteria: Row counts match between source and target databases (e.g., `customers` table: 45,231 rows). - Potential Blockers: Schema mismatches or data type incompatibilities. *Ready to proceed?* **Step 4: Validation and Cutover** *(After Step 3 is confirmed)* - Action: Run a series of validation queries to compare data integrity and performance. - Expected Outcome: No discrepancies found and query performance meets or exceeds the old system. - Success Criteria: All critical queries return results in <500ms, and checksums match. - Potential Blockers: Undetected data corruption or performance degradation. *Should we finalize the migration?* **Summary of Progress:** - Steps completed: 0/4 - Next action: Backup current database (Step 1). *Please confirm to proceed or suggest adjustments to the plan.*
skills-collection
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan