Maintenance in progress: we are indexing a large batch of new skills. Some pages may load slowly or briefly show no results. Nothing is lost, and everything is back to normal within the hour.

Systematic Debugging

Use when encountering any bug, test failure, or unexpected behavior — before proposing fixes.

thedixitjain aeefa01 1.2 KB Updated 2 repo stars

File contents

Systematic Debugging

Four Phases

Phase 1: Reproduce

  • Get a minimal, reliable reproduction
  • Never fix what you can't reproduce

Phase 2: Understand

  • Read the error message fully — the answer is often there
  • Trace the call path from symptom to root cause
  • Check: recent changes, environment differences, assumptions about inputs

Phase 3: Hypothesize

  • Form 1-3 specific hypotheses about root cause
  • Test each hypothesis with the smallest possible change
  • Never change multiple things at once

Phase 4: Fix and Verify

  • Fix the root cause, not the symptom
  • Run the reproduction case — confirm fixed
  • Run full test suite — confirm no regressions
  • Invoke hotl:verification-before-completion

Red Flags

  • "Let me try X and see what happens" without a hypothesis
  • Changing multiple things before verifying
  • Marking done without running full tests

Source: hashgraph-online/awesome-codex-pluginsplugins/yimwoo/hotl-plugin/skills/systematic-debugging/SKILL.md

thedixitjain/the-mega-skill-library/tree/main/library/engineering-core/systematic-debugging--hashgraph-online-3 commit aeefa0158e

Frequently asked questions

npx skillmds add thedixitjain/systematic-debugging-5