🧰 Engineering Essentials · Debugging Craft

Hunt bugs systematically (Python)

Reproduce, bisect, hypothesize, verify — the method that beats random poking under deadline pressure.

foundation~30 minAll Software Engineers

Steps

1Reproduce deterministically first; flaky repro = flaky fix
2Write failing test capturing the bug before touching source
3Bisect history or code path until minimal failing case remains
4Form ONE hypothesis, predict its observable, then check
5Fix root cause, not nearest symptom; add regression test
6Document the hunt briefly for future searchers
7Profile with py-spy and cProfile; watch the GIL on CPU-bound paths
8Pin environments via lockfiles; verify wheels exist for your platforms

Common Pitfalls

▲Shotgun changes stacking unknown unknowns
▲Fixing symptoms while root cause ships elsewhere

Commands

Install with skills CLI

$ npx skills add aniruddhaadak80/skills --skill debug-craft-systematic-bug-hunt-python

Install globally

$ npx skills add aniruddhaadak80/skills --skill debug-craft-systematic-bug-hunt-python -g

Tags

#debugging#methodology#engineering-essentials#debug-craft

Install this skill

$ npx skills add aniruddhaadak80/skills --skill debug-craft-systematic-bug-hunt-python -a opencode

SKILL.md

# Hunt bugs systematically (Python)

> Reproduce, bisect, hypothesize, verify — the method that beats random poking under deadline pressure.

## When to Use This Skill

Reproduce, bisect, hypothesize, verify — the method that beats random poking under deadline pressure.

## Steps

1. Reproduce deterministically first; flaky repro = flaky fix
2. Write failing test capturing the bug before touching source
3. Bisect history or code path until minimal failing case remains
4. Form ONE hypothesis, predict its observable, then check
5. Fix root cause, not nearest symptom; add regression test
6. Document the hunt briefly for future searchers
7. Profile with py-spy and cProfile; watch the GIL on CPU-bound paths
8. Pin environments via lockfiles; verify wheels exist for your platforms

## Common Pitfalls

- Shotgun changes stacking unknown unknowns
- Fixing symptoms while root cause ships elsewhere

View source on GitHub ↗

Reproduce, bisect, hypothesize, verify — the method that beats random poking under deadline pressure.

🧰 Engineering Essentials·~30m

Open →

Hunt bugs systematically (Go)foundation

Reproduce, bisect, hypothesize, verify — the method that beats random poking under deadline pressure.

🧰 Engineering Essentials·~30m

Open →

Hunt bugs systematically (Rust)foundation

Reproduce, bisect, hypothesize, verify — the method that beats random poking under deadline pressure.

🧰 Engineering Essentials·~30m

Open →