plan-execute

What problem does it solve?

This Skill eliminates the high risk and potential for costly mistakes associated with complex code changes by enforcing a structured, two-phase planning and execution workflow. It provides explicit approval gates and rollback capabilities, ensuring safe and auditable refactoring.

Core Features & Use Cases

• Explicit YAML Plans: Generates a detailed, human-reviewable YAML plan outlining all steps, dependencies, and risks before any code is touched.
• Approval Gates & Checkpointing: Requires user confirmation for high-risk steps and creates Git checkpoints, allowing for instant rollback if issues arise.
• 90% First-Pass Success: Achieves a significantly higher success rate for complex tasks compared to ad-hoc changes, reducing debugging time.
• Use Case: Refactor a critical authentication module to use JWT, involving multiple file changes and potential breaking points. The skill will generate a plan, ask for approval at each sensitive step, and create checkpoints, ensuring a safe and auditable transition.

Quick Start

User initiates a complex refactoring task

User: Use Plan-Execute: Refactor authentication to use JWT instead of sessions

Agent generates a detailed YAML plan for review

(User reviews and approves)

Agent executes step-by-step with checkpoints and approvals

Agent: ✓ Step 1 (analyze): Found 8 files using sessions Agent: → Step 3 (refactor-login): APPROVAL REQUIRED Agent: Will modify: src/routes/auth/login.js (critical auth logic) Agent: Proceed? (y/n/skip)