refactor-design

What problem does it solve?

This Skill produces a careful, incremental refactor plan to address duplicate logic, architectural violations, and large-area structural changes while minimizing risk to the codebase and consumers.

Core Features & Use Cases

• Incremental, testable steps: Breaks refactors into small, independently verifiable commits with explicit verification criteria.
• Dependency-aware ordering: Orders changes by dependency so later steps safely build on earlier ones.
• Safety guardrails: Highlights API migration paths, verification checks, and rollback-friendly boundaries.
• Integration with task tracking: Creates and updates tasks to track progress and spawn exploration sub-agents for discovery.
• Use Case: Consolidate duplicated validation logic into a shared utility, or restructure a subsystem to separate domain and infrastructure concerns without breaking consumers.

Quick Start

Use the refactor-design skill to analyze the target area and produce an ordered, testable refactor plan with current and target code examples and acceptance criteria.