| name | refactor |
|---|---|
| description | Invoke IMMEDIATELY via python script when user requests refactoring analysis, technical debt review, or code quality improvement. Do NOT explore first - the script orchestrates exploration. |
Refactor
When this skill activates, IMMEDIATELY invoke the script. The script IS the workflow.
Invocation
| Argument | Required | Description |
|---|---|---|
--step |
Yes | Current step (starts at 1) |
--total-steps |
Yes | Total steps (5 for full workflow) |
--n |
No | Number of categories to explore (default: 10) |
Do NOT explore or analyze first. Run the script and follow its output.
Workflow Phases
- Dispatch - Launch parallel Explore agents (one per category)
- Triage - Structure smell findings with IDs
- Cluster - Group smells by shared root cause
- Contextualize - Extract user intent, prioritize issues
- Synthesize - Generate actionable work items
Determining N (category count)
Default: N = 10
Adjust based on user request scope:
- SMALL (single file, specific concern, "quick look"): N = 5
- MEDIUM (directory, module, standard analysis): N = 10
- LARGE (entire codebase, "thorough", "comprehensive"): N = 25
The script randomly selects N categories from the 38 available code quality categories defined in conventions/code-quality/.