agentic-os/skills/systematic-debug/SKILL.md

name	description	version	author	tags
systematic-debug	4-phase root cause analysis and debugging	1.0.0	Agentic OS	debugging bug fix root-cause

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