cyberneticlibrary

Debug runtime failures systematically

debuggingskillsetup L261,462
code-yeongyu/oh-my-openagent
What it does

Hypothesis-driven debugging across any runtime or binary

Best for

Production bugs and flaky tests when you need runtime truth instead of plausible code stories.

Inputs
  • · crash, hang, silent failure, or wrong response
  • · source code or binary (optional)
Outputs
  • · root cause confirmed by observed state
  • · minimal fix with failing test locked in
  • · verification via actual system use
Requires
  • · language-specific debugger (pdb, node inspect, lldb, gdb, dlv, pwndbg)
  • · Playwright for browser bugs
  • · language/binary-specific references
Preconditions

Runtime accessible; debugger available for target language

Failure modes
  • · Code reading replaces runtime investigation
  • · Debugging artifacts not cleaned
  • · Source-map failures silent (Node.js tsx gotcha)
  • · Async/race conditions not reproducible
Trust signals
  • · MANDATORY: reads runtime-specific reference (python.md, node.md, rust.md, go.md, native-binary.md) before attaching
  • · Leaves no debugging artifacts (journals then removes)
  • · Two-discipline rule: runtime truth > code reading, no trace