# Systematic Debug

> 4-phase root cause analysis and debugging

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

---


# Systematic Debugging

## Description
Four-phase debugging methodology: reproduce, investigate, fix, verify. Prevents guesswork and ensures root cause is found before any fix is applied.

## When to Use
- Encountering a bug or error
- System failure or crash
- Unexplained behavior
- Performance regression

## Process
1. **Reproduce**: Capture exact steps, environment, and error output
2. **Investigate**: Trace root cause through logs, stack traces, and code analysis
3. **Fix**: Apply minimal fix addressing root cause (not symptoms)
4. **Verify**: Confirm fix resolves the issue and doesn't introduce regressions
5. Update learnings.md with debugging insights

## Safety
- If 3 fix attempts fail, trigger architectural review
- Never apply workaround without understanding root cause

## Output
Debug report: symptoms, root cause, fix applied, verification results

## Agent Assignment
- Primary: opencode