fix-test git:20260319.53ed0cfA

Immutable. This exact content is served forever at /api/v1/blob/98ac58a794e389af.

---
name: fix-test
description: "Auto-diagnose and fix failing tests. Identifies root causes (mock mismatches, assertion drift, import errors, etc.), applies fixes, and re-runs to verify — up to 3 attempts per test. Triggers on: fix test, fix failing test, test failure, broken test, test error, why is this test failing, debug test."
argument-hint: "<test file or pattern>"
disable-model-invocation: true
---

# Fix Test

Auto-diagnose and fix failing tests with up to 3 retry
attempts.

## Scoping

Before running, ask:

1. **Target**: "Which test is failing? A specific file,
   test name, or should I find failures automatically?"
2. **Context**: "Did this start failing after a recent
   change, or has it been broken?"

## Execution

### Step 1: Identify Failures

Run the failing test(s) to capture the error:

```bash
uv run pytest <target> -v --tb=short 2>&1 | tail -40
```

### Step 2: Diagnose Root Cause

Common failure patterns:

| Pattern | Root Cause | Fix |
| ------- | ---------- | --- |
| `ModuleNotFoundError` | Import path changed | Update import |
| `AttributeError: mock` | Mock target wrong | Match import path |
| `AssertionError` | Expected value drift | Update assertion |
| `TypeError: __init__` | Constructor changed | Update call site |
| `FileNotFoundError` | Fixture path wrong | Use `tmp_path` |

### Step 3: Apply Fix and Re-run

Apply the fix, then re-run the test. If it still fails,
diagnose again with the new error. Repeat up to 3 times.

```bash
uv run pytest <target> -v --tb=short
```

### Step 4: Report

After fixing (or exhausting 3 attempts), report:

```markdown
## Fix Test Results

**Tests Fixed:** X/Y | **Attempts Used:** Z/3

### Fixed
| Test | Root Cause | Fix Applied |
|------|------------|-------------|

### Still Failing (if any)
| Test | Error | Attempts | Notes |
|------|-------|----------|-------|
```

## Follow-Up

After presenting results, offer:

- "Want me to generate missing tests for the fixed
  module?"
- "Should I check for similar failures elsewhere?"
- "Want a deeper look at the root cause?"