Test-first bug fixing

Enforce a disciplined bug-fixing workflow that prevents regression and parallelizes fix attempts.

Core workflow

When a bug is reported, follow these steps in order:

Phase 1: Reproduce and document

1. Understand the bug — Gather details about expected vs actual behavior
2. Identify the test location — Determine where tests live in the project (check for tests/, __tests__/, spec/, *.test.*, *.spec.* patterns)
3. Write a failing test — Create a test that demonstrates the bug

Phase 2: Fix with subagents

4. Launch fix subagents — Use the Task tool with subagent_type=general-purpose to attempt fixes
5. Run the test — Verify the fix by running the specific test
6. Iterate if needed — If test still fails, launch additional subagents with new approaches