# Systematic Debugging Best Practices

> Sub-skill of systematic-debugging: Best Practices.

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

---


# Best Practices

## Best Practices


### Do


1. Reproduce before investigating
2. Document investigation steps
3. Test one hypothesis at a time
4. Write regression test for every bug fix
5. Share findings with team
6. Update documentation when environment-related

### Don't


1. Jump to conclusions
2. Make multiple changes at once
3. Fix symptoms instead of causes
4. Skip the hypothesis step
5. Merge fixes without tests
6. Ignore intermittent failures