🧰 Engineering Essentials · Debugging Craft

Hunt bugs systematically (Swift)

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
7Adopt Swift Concurrency (async/await, actors) for data-race safety
8Profile Instruments templates: Time Profiler + Allocations together

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

Install globally

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

Tags

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

Install this skill

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

SKILL.md

# Hunt bugs systematically (Swift)

> 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. Adopt Swift Concurrency (async/await, actors) for data-race safety
8. Profile Instruments templates: Time Profiler + Allocations together

## 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 (Python)foundation

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 →