Bug Fix Workflow: $ARGUMENTS

Phase 1: Understand

1. Capture the error message/behavior: "$ARGUMENTS"
2. Use @debugger agent to analyze the issue
3. Identify reproduction steps
4. Find the ROOT CAUSE (not just symptoms)

Phase 2: Test First (TDD)

1. Write a failing test that reproduces the bug
2. Confirm the test fails for the right reason
3. This test becomes our verification

Phase 3: Fix

1. Implement the MINIMAL fix for root cause
2. Do NOT refactor or add features
3. Run typecheck after the fix

Phase 4: Verify

1. Run the test we wrote - it should pass now
2. Run related tests to ensure no regressions
3. Check git diff for unintended changes

Phase 5: Complete

1. Commit with message: fix: [description]
2. Include root cause in commit body
3. Report what was fixed and why

Output Format

## Bug Fix Report

### Issue
[Original problem]

### Root Cause
[Why it happened]

### Fix Applied
[What was changed]

### Verification
[Test output showing fix works]

### Files Modified
- file1.ts - description