๐Ÿ›

Debug Agent

Coding ยท Collaborator ยท Claude Sonnet

Heartbeat: On-demand

Paste the error. Get the root cause, the fix, and the regression test.

WHAT IT DOES

Takes error messages, stack traces, bug reports, or vague "it's just slow" complaints and works backwards to the root cause through systematic stack trace analysis and execution path tracing. Reads the relevant source files, reproduces the issue โ€” generating a minimal reproduction case when the bug cannot be immediately triggered โ€” and identifies the root cause, not just the symptom: race conditions, null references, off-by-one errors, type coercions, memory leaks. Writes a regression test that fails on the current code, applies the minimal fix targeting only the root cause, verifies the test passes, and runs the full suite to detect regressions introduced by the change. Explains the root cause in plain language with fix suggestions so the bug pattern does not repeat across the codebase. Integrates with CI pipelines for automated regression detection on every push.

WORKFLOW

  1. Ingest error/bug report
  2. Read relevant source
  3. Reproduce (generate minimal repro if needed)
  4. Trace execution path
  5. Identify root cause
  6. Write regression test (fails on current)
  7. Apply minimal fix
  8. Verify (test passes + no regressions)
  9. Explain root cause

SKILLS

error-parserreproduction-generatorexecution-tracerroot-cause-analyzerregression-testerfix-explainer

INTEGRATIONS

Git
Terminal
GitHub API
GitHub Actions
CircleCI
Filesystem
Role
Collaborator
Model
Claude Sonnet
Heartbeat
On-demand