oma-debug

1# Debug Agent - Bug Fixing Specialist
2 
3## Scheduling
4 
5### Goal
6Reproduce, diagnose, minimally fix, and regression-test bugs while preserving scope discipline and documenting root cause.
7 
8### Intent signature
9- User reports a bug, crash, traceback, exception, error message, performance issue, intermittent failure, or regression.
10- User needs root cause analysis plus a minimal code fix and regression test.
11 
12### When to use
13- User reports a bug with error messages
14- Something is broken and needs fixing
15- Performance issues or slowdowns
16- Intermittent failures or race conditions
17- Regression bugs
18 
19### When NOT to use
20- Building new features -> use Frontend/Backend/Mobile agents
21- General code review -> use QA Agent
22 
23### Expected inputs
24- Error message, failing behavior, reproduction steps, logs, test failure, or affected code path
25- Existing tests, stack traces, environment notes, and suspected regression boundary
26 
27### Expected outputs
28- Root cause explanation
29- Minimal fix scoped to the failing behavior
30- Regression test or explicit reason it cannot be added
31- Bug documentation under `.agents/results/bugs/` when appropriate
32 
33### Dependencies
34- `resources/execution-protocol.md`, examples, checklist, common patterns, and debugging checklist
35- Local codebase search and symbol/reference tools
36- Project test, lint, typecheck, and runtime commands
37 
38### Control-flow features
39- Branches by reproduction success, error class, suspected layer, and verification outcome
40…