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.