Refactor

Refactor code matching $ARGUMENTS across the codebase using parallel Snipper agents for maximum speed.

Process

Phase 1: Discovery

1. •

   Parse the refactor request from $ARGUMENTS

   • •Identify: method name, component name, pattern, or code smell
   • •Choose search strategy: Grep for code patterns, Glob for file patterns
2. •

   Find all affected files

   • •Use Grep/Glob to search the codebase
   • •Exclude: node_modules, .git, dist, build
   • •If >15 files found, ask user to confirm or narrow scope

Phase 2: Create Instructions

1. •

   Create task folder: .claude/tasks/refactor-{timestamp}/

2. •

   Create ONE instruction file at instructions.md:

# Refactor: {title}

## Objective
{What to refactor - derived from $ARGUMENTS}

## Pattern to Find
{Exact code pattern or structure to locate}

## Transformation
{How to transform - be specific and adaptive}

## Examples
Before:
{current code}

After:
{refactored code}

## Constraints
- Only modify code matching the pattern
- Preserve all existing functionality
- Follow codebase conventions

Phase 3: Execute in Parallel

1. •

   Group files into batches of max 3 files each

2. •

   Launch Snipper agents in parallel - ALL batches in a SINGLE message:

Using instructions in .claude/tasks/refactor-{id}/instructions.md, refactor:
- {file_1}
- {file_2}
- {file_3}

Read instructions first, then apply the refactor to each file.

Phase 4: Verification

1. •

   Validate changes

   • •Run pnpm lint (if available)
   • •Run pnpm tsc (if TypeScript)
2. •

   Report summary

   • •Files modified
   • •Errors encountered
   • •Next steps if needed

Example

User: /refactor rename getUserData to fetchUserProfile

1. •Grep finds 12 files containing "getUserData"
2. •Creates .claude/tasks/refactor-1702489200/instructions.md
3. •Groups into 4 batches of 3 files
4. •Launches 4 Snipper agents in parallel
5. •Runs lint, reports: "Refactored 12 files"