# Debugging

> Diagnose and repair software failures using evidence, reproduction, instrumentation, and regression tests rather than speculative edits.

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

---


# Debugging

1. Reproduce the failure with the exact command, input, environment, and observed output.
2. Separate symptom, trigger, and root cause. Inspect logs, stack traces, state transitions, recent diffs, and boundary conditions.
3. Add temporary targeted instrumentation when evidence is missing; avoid broad logging noise.
4. Fix the root cause at the narrowest ownership boundary.
5. Add a regression test that fails before the fix and passes after it.
6. Remove temporary diagnostics and rerun the original reproduction plus nearby tests.