plan-execute

Generate YAML plans with approval gates for multi-file code changes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dredd-us/seashells --skill plan-execute-dredd-us
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-execute
Source: https://github.com/dredd-us/seashells/tree/main/.claude/skills/plan-execute
Command: npx skills add https://github.com/dredd-us/seashells --skill plan-execute-dredd-us

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, and includes templates (resource) components.

What problem does it solve?

This Skill prevents costly mistakes in complex coding tasks by enforcing a two-phase workflow: explicit YAML plan generation followed by controlled execution with approval gates, achieving a 90% first-pass success rate.

Core Features & Use Cases

  • Explicit Planning: Generates a detailed YAML plan for multi-file changes, refactoring, or bug fixes.
  • Approval Gates & Checkpointing: Requires user confirmation for high-risk steps and creates checkpoints for easy rollback.
  • Use Case: Refactor an authentication module to use JWT. The AI will first generate a detailed plan, ask for your approval on critical steps, and create Git checkpoints, ensuring a safe and auditable process.

Quick Start

Use the plan-execute skill to refactor the 'auth.py' module to use a new JWT library.

Frequently Asked Questions about plan-execute

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely execute complex refactoring across multiple files?

Plan-execute generates a detailed YAML plan before execution, breaking down multi-file refactoring into sequenced steps with approval gates and Git checkpoints. This two-phase workflow reduces errors and enables rollback if issues arise.

What's the best way to coordinate interdependent code changes with audit trails?

Create explicit plans that map prerequisites, dependencies, and rollback strategies for each step. Plan-execute enforces checkpointing after validation, maintaining a complete audit trail of what changed and why.

Can I use plan-execute for database migrations and API refactors?

Yes. Plan-execute handles risky tasks including database migrations, API changes across modules, and authentication rewrites by generating prerequisite checks, success criteria, and rollback procedures before execution begins.

How do I roll back changes if a multi-file refactor fails mid-execution?

Plan-execute creates Git checkpoints at each step and includes rollback strategy in the YAML plan, allowing you to revert to the last successful checkpoint without manual recovery.

What happens if I don't get approval gates for high-risk changes?

Approval gates are built into the plan-execute workflow for high-risk steps, requiring explicit user confirmation before proceeding. This prevents accidental execution and ensures stakeholder sign-off on critical modifications.