Systematic Debugging

Systematic Debugging

lubochka Updated

File contents

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

lubochka/xiigen-general-skills/tree/main/skills/universal/systematic-debugging commit a2e4224fc8

Frequently asked questions

npx skillmds@latest add lubochka/systematic-debugging-3