# Debugging

> Systematic debugging protocol

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

---


# Systematic Debugging

Never fix without understanding the root cause.

## Step 1: Reproduce

- Capture exact error message
- Note the inputs that trigger it
- Document the expected vs actual behavior

## Step 2: Isolate

- Find the smallest reproducing case
- Check if issue is deterministic
- Identify affected components

## Step 3: Hypothesize

- List 3 potential root causes
- Rank by probability
- Pick one to investigate

## Step 4: Verify

- Add logging or breakpoints
- Run with minimal change
- Confirm or refute hypothesis

## Step 5: Fix

- Implement targeted fix
- Add regression test
- Verify fix doesn't break elsewhere

## Anti-Patterns

- Never try random changes
- Never silence exceptions
- Never assume environment issue without proof