local-review

Provide a code review for uncommitted local changes (both staged and unstaged).

Optional Focus: If the user provided an argument, use it as the primary focus for the review. The argument might be:

• A specific area to focus on (e.g., "focus on the payment flow")
• Context about what changed (e.g., "I refactored the auth module")
• Specific concerns to check (e.g., "make sure the error handling is correct")
• A method or file to prioritize (e.g., "check the handleSubmit function")

When a focus is provided, all review agents should:

1. Prioritize issues related to the focus area
2. Provide more detailed analysis of the focused area
3. Still check for critical issues elsewhere, but weight the focus area higher

To do this, follow these steps precisely:

1. Use a Haiku agent to check the current state of the working directory:

   • Run git status to see what files have changes
   • Run git diff for unstaged changes and git diff --staged for staged changes
   • If there are no changes, do not proceed and inform the user
   • Return a summary of what files changed and the nature of the changes
   • If a focus argument was provided, note which files/changes are most relevant to that focus

2. Use another Haiku agent to find any relevant CLAUDE.md files: the root CLAUDE.md file (if one exists), as well as any CLAUDE.md files in the directories containing modified files

3. Then, launch 5 parallel Sonnet agents to independently code review the changes. Each agent should read the full file context when needed. If a focus argument was provided, include it in each agent's prompt so they prioritize that area. The agents should return a list of issues and the reason each issue was flagged: a. Agent #1: Audit the changes to make sure they comply with any CLAUDE.md guidelines found. Note that CLAUDE.md is guidance for Claude as it writes code, so not all instructions will be applicable during code review. b. Agent #2: Read the file changes, then scan for bugs, logic errors, and edge cases. Focus on significant bugs, avoid nitpicks. Check for: null/undefined issues, off-by-one errors, race conditions, resource leaks, error handling gaps. c. Agent #3: Scan for security vulnerabilities (OWASP top 10): injection flaws, XSS, auth bypass, sensitive data exposure, insecure dependencies, etc. d. Agent #4: Check for TypeScript type safety issues, performance problems, and code quality concerns that would fail code review. e. Agent #5 (Code Simplifier): You are an expert code simplification specialist focused on enhancing code clarity, consistency, and maintainability while preserving exact functionality. Your expertise lies in applying project-specific best practices to simplify and improve code without altering its behavior. You prioritize readable, explicit code over overly compact solutions.

   Analyze the changed code and flag issues related to:

   1. Preserve Functionality: Flag any simplification that would change what the code does - only how it does it matters. All original features, outputs, and behaviors must remain intact.

   2. Apply Project Standards: Flag violations of coding standards from CLAUDE.md including:

      • Use ES modules with proper import sorting and extensions
      • Prefer function keyword over arrow functions
      • Use explicit return type annotations for top-level functions
      • Follow proper React component patterns with explicit Props types
      • Use proper error handling patterns (avoid try/catch when possible)
      • Maintain consistent naming conventions

   3. Enhance Clarity: Flag code that could be simplified by:

      • Reducing unnecessary complexity and nesting
      • Eliminating redundant code and abstractions
      • Improving readability through clear variable and function names
      • Consolidating related logic
      • Removing unnecessary comments that describe obvious code
      • IMPORTANT: Flag nested ternary operators - prefer switch statements or if/else chains for multiple conditions
      • Choose clarity over brevity - explicit code is often better than overly compact code