🧰 Engineering Essentials · Debugging Craft

Hunt bugs systematically (Node.js)

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 --cpu-prof and clinic; inspect event-loop lag
8Guard against blocking calls in hot paths with async worker offload

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-node

Install globally

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

Tags

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

Install this skill

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

SKILL.md

# Hunt bugs systematically (Node.js)

> 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 --cpu-prof and clinic; inspect event-loop lag
8. Guard against blocking calls in hot paths with async worker offload

## 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 →