Code Refactoring

Refactoring is a behavior-preserving change surface, not a license to redesign the system while cleanup is in flight. Keep the work scoped, reversible, and backed by proof that behavior still holds.

When to use this skill

• Simplify complex or duplicated code without changing intended behavior
• Break a large function, file, class, or component into smaller reviewable pieces
• Clean up naming, boundaries, or repeated logic before adding more features
• Plan or execute a repeated migration or codemod-style cleanup safely
• Reduce technical debt when the user wants a clearer implementation, not a new design

Prefer a neighboring skill when the main job is different: