Systematic Debugging

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

lubochka 37b52cd 813 B 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/agent-skills/systematic-debugging commit 37b52cda61

Frequently asked questions

npx skillmds@latest add lubochka/systematic-debugging