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/.