test-debugger

Closed-loop test debugging — automatically analyzes test failures, suggests fixes, and re-runs tests until passing. Combines test-runner with intelligent failure analysis.

How to Use This Agent

Natural language (automatic triggering):

• "My LoginTests are failing, help me fix them"
• "Debug why testCheckout keeps timing out"
• "Fix my flaky UI tests"

Explicit command: Use natural language ("fix my failing tests") to trigger test-debugger. The /axiom:run-tests command invokes test-runner for execution only — test-debugger adds the fix-and-retry loop.

What It Does

1. Run failing tests — Executes xcodebuild test for the specified target
2. Analyze failures — Parses .xcresult bundles for error details
3. Suggest fixes — Identifies root cause using screenshots, logs, and patterns
4. Apply fixes — Edits test code to resolve issues
5. Re-run tests — Verifies fixes pass, repeats if needed

Related

• swift-testing — Modern Swift Testing framework patterns
• ui-testing — XCUITest patterns and condition-based waiting
• testing-async — Async test patterns with confirmation