systematic-debugging

Diagnose software bugs through a four-phase root cause investigation workflow.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/i-bebsi/hermes-agent --skill systematic-debugging-i-bebsi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/i-bebsi/hermes-agent/tree/main/hermes-config/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/i-bebsi/hermes-agent --skill systematic-debugging-i-bebsi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Random fixes and guess-and-check patching waste hours and introduce new bugs. This Skill enforces a disciplined four-phase debugging process that finds the root cause before any fix is attempted, preventing symptom-only patches and repeated failed fix attempts. ## Core Features & Use Cases - Four-Phase Process: Root cause investigation, pattern analysis, hypothesis testing, and implementation, each with explicit completion criteria. - Evidence Gathering: Read error messages, reproduce failures, check recent git changes, and trace data flow across component boundaries before proposing fixes. - Rule of Three: After three failed fixes, stop and question the architecture instead of attempting a fourth patch. - Use Case: A production API test fails intermittently. Follow Phase 1 to reproduce it with pytest, trace the bad value upstream through the call stack, form a single hypothesis, write a regression test, and fix the actual source rather than the symptom. ## Quick Start Use the systematic-debugging skill to investigate why this failing test produces a null value and find the root cause before fixing it.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a failing test systematically?▼

Start by reading the full error message and stack trace, then reproduce the failure consistently with a command like pytest -v. Check recent git changes, trace the bad value upstream to its source, and only then form a hypothesis and write a regression test before fixing.

What is root cause analysis in software debugging?▼

Root cause analysis means identifying why a bug occurs before attempting any fix, rather than patching symptoms. It involves reproducing the issue, gathering evidence at component boundaries, and tracing data flow until the originating source is found.

When should I stop trying fixes and question the architecture?▼

Stop after three failed fix attempts. If each fix reveals new shared state or coupling in a different place, or requires massive refactoring, the pattern itself is likely flawed and needs architectural discussion rather than another patch.

Does systematic debugging work for production incidents under time pressure?▼

Yes, the process is designed especially for emergencies because guessing under pressure causes thrashing and rework. A structured investigation typically resolves issues in 15-30 minutes versus hours of random fix attempts.

Why do quick fixes create more bugs?▼

Quick fixes address symptoms without understanding the underlying cause, so the real defect remains and the patch often introduces new coupling or side effects. Untested fixes also lack regression coverage, letting the bug resurface later.