refactor-pass

name	refactor-pass
description	Perform a refactor pass focused on simplicity after recent changes. Use when the user asks for a refactor/cleanup pass, simplification, dead-code removal, or says "refactor pass".

Refactor Pass

Workflow

1. Review recent changes — identify simplification opportunities:

   • git diff for unstaged changes
   • git diff --cached for staged changes
   • git log --oneline -5 for recent commits if no uncommitted changes

2. Apply refactors (in priority order):

   • Remove dead code and unreachable paths
   • Straighten convoluted logic flows
   • Remove excessive parameters or intermediary variables
   • Remove premature optimization (unnecessary useMemo, useCallback, etc.)
   • Extract duplicated logic into custom hooks (src/hooks/) or shared components (src/components/)

3. Verify — run all three checks:

   yarn build && yarn lint && yarn type-check
   

4. Optional suggestions — identify abstractions or reusable patterns only if they clearly improve clarity. Keep suggestions brief; don't refactor speculatively.

Project-Specific Patterns to Enforce

When refactoring, watch for these anti-patterns from AGENTS.md:

Anti-pattern	Refactor to
useState for shared state	Zustand store in src/stores/