ifiokjr/monopi/debug-helper

Debug Helper

Systematic debugging workflow.

Error Analysis

1. Read the error: full stack trace and error message
2. Locate: find the source file and line

``bash # Search for the error origin grep -rn "ErrorClass\|error_function" src/ ``

1. Context: read surrounding code (±30 lines)
2. Reproduce: identify minimal reproduction steps
3. Root cause: trace the data flow to find where it goes wrong
4. Fix: minimal change that addresses the root cause
5. Verify: run the failing case to confirm the fix

Log Analysis

1. Read the log file or output
2. Identify patterns: timestamps, error levels, request IDs
3. Correlate events across log lines
4. Summarize: what happened, when, and why

Performance Profiling

1. Measure: get baseline numbers first

``bash time <command> ``

1. Profile: use language-appropriate tools:

• Node.js: --prof, clinic.js
• Python: cProfile, py-spy
• Go: pprof

1. Identify: find the hotspot (usually 1-2 functions)
2. Optimize: fix the bottleneck
3. Verify: measure again, compare with baseline