| name | debug |
| description | Structured debugging — reproduce, diagnose, fix with @omg:debugger agent |
| tags | ["debugging"] |
When to Use
- Bug needs systematic investigation
- User says "debug" or reports an error/failure
Workflow
- Invoke @omg:debugger with the error/symptom
- Debugger reproduces, investigates root cause, recommends minimal fix
- If fix needed, invoke @omg:executor to apply it
- Verify fix via
bash
Structured Handoff
When invoking @omg:executor for the fix:
- Persist diagnosis to
.omg/research/debug-{issue}.md
- Include in executor prompt ONLY: (1) exact file:line from Root Cause, (2) specific Fix, (3) Verification command
- If Similar Issues found, create one additional task per location
Trigger Keywords
debug, error, failure, broken
Example
copilot -i "debug: tests failing in src/pipeline/"
Quality Contract
- Root cause identified, minimal fix applied, verified