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.