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)