/refactor

Refactor code across multiple files using parallel Snipper agents.

Usage

/refactor rename getUserData to fetchUserProfile
/refactor convert class components to functional
/refactor extract common validation logic

Workflow

1. Discovery

• Parse the refactor request
• Find all affected files (Grep/Glob)
• Analyze scope (confirm if >15 files)

2. Create Instructions

• Generate unique task ID
• Create .claude/tasks/refactor-{id}/
• Write ONE instructions.md with:
  • Clear objective
  • What to change
  • How to change
  • Rules to follow

3. Launch Parallel Agents

• Batch files (max 3 per agent)
• Launch Snipper agents in parallel
• Pass instructions file path

4. Collect Results

• Wait for all agents to complete
• Verify all files modified
• Report summary

File Batching

Output

Refactored 12 files:
- src/auth/*.ts: Updated function names
- src/api/*.ts: Extracted validation logic

Priority

Consistency > Speed. All files refactored identically.