Refactor Workflow Skill

Overview

Two-track workflow for improving existing code. Polish track for small, contained refactors; overhaul track for architectural changes and migrations. Both tracks emphasize exploration before commitment and mandatory documentation updates.

Triggers

Activate this skill when:

• User runs {{COMMAND_PREFIX}}refactor command
• User wants to improve existing code structure
• User mentions "refactor", "restructure", "clean up", "migrate"
• User asks to "move", "extract", "rename", or "reorganize" code

Disambiguation: If the user says "fix" or "clean up" — use {{COMMAND_PREFIX}}refactor when the code works but needs structural improvement. Use {{COMMAND_PREFIX}}debug when something is broken (error, crash, wrong behavior).

Workflow Overview