# Systematic Debugging

> Systematic Debugging

- Skill: `lubochka/systematic-debugging-3` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lubochka/systematic-debugging-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lubochka/systematic-debugging-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lubochka (https://skillmd.com/u/lubochka)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/lubochka/systematic-debugging-3

---

# Systematic Debugging

## Purpose
Make debugging reproducible and disciplined.

## When to Use
Use for unclear failures, regressions, or unstable behavior.

## Inputs
Symptoms, hypotheses, commands, code boundaries, observations.

## Steps
1. Write down hypotheses.
2. Test one hypothesis at a time.
3. Record the observation.
4. Update the hypothesis list before changing direction.

## Gates
Debugging has a clear trail of tested ideas and outcomes.

## Evidence
Debug notes, command output, reduced repro, or identified culprit.

## Anti-Patterns
Random edits, mixed hypotheses, and unrecorded attempts.

## Related
`debug-session`, `root-cause-tracing`