Documentation
README
Systematic Debugging
A structured approach to finding and fixing bugs.
The Debugging Loop
1. REPRODUCE β 2. ISOLATE β 3. DIAGNOSE β 4. FIX β 5. VERIFY
Never skip steps. Never guess-and-check repeatedly.
Step 1: Reproduce
- Run the exact command that fails
- Capture FULL output (stdout AND stderr)
- Note: exit code, error message, stack trace
- If intermittent, identify what changes between runs
Step 2: Isolate
- What's the MINIMAL input that triggers the error?
- Which specific line/function fails? (read the traceback bottom-up)
- Is it a compile error, runtime error, or wrong output?
- Does it fail on all inputs or specific ones?
Step 3: Diagnose
Read the error message carefully
This is the opening of the README. Read the full README on GitHub.