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