# Systematic Debugging

> Make debugging reproducible and disciplined. Use for unclear failures, regressions, or unstable behavior.

- Skill: `lubochka/systematic-debugging` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lubochka/systematic-debugging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lubochka/systematic-debugging/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: lubochka (https://skillmd.com/u/lubochka)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lubochka/systematic-debugging

---


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