systematic-debugging

Diagnose bugs through root cause investigation before proposing any fix.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/xegheplimo-web/hermes-ops --skill systematic-debugging-xegheplimo-web
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/xegheplimo-web/hermes-ops/tree/main/skills/software-development/execution-discipline/systematic-debugging
Command: npx skills add https://github.com/xegheplimo-web/hermes-ops --skill systematic-debugging-xegheplimo-web

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers under time pressure often apply symptom-level fixes that fail repeatedly because the true root cause was never identified. This Skill enforces a disciplined four-phase debugging methodology that requires root cause investigation before any fix attempt, preventing wasted cycles on guesswork. ## Core Features & Use Cases - Four-Phase Debugging Process: Root cause investigation, pattern analysis, hypothesis testing, and verified implementation with failing test cases. - Root Cause Tracing: Trace bugs backward through the call stack to find the original trigger instead of fixing where the error appears. - Defense-in-Depth Validation: Add validation at entry points, business logic, environment guards, and debug instrumentation layers to make bugs structurally impossible. - Use Case: When a CI pipeline fails deep in a multi-component build, instrument each component boundary, gather evidence showing where data breaks, trace the failure to its source, and fix it with a regression test. ## Quick Start Use the systematic-debugging skill to investigate this failing test and find its root cause before suggesting any fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a bug instead of fixing symptoms?

Root cause investigation starts by reading error messages completely, reproducing the issue consistently, and checking recent changes. Then trace the failure backward through the call stack until you find the original trigger, and fix at that source rather than where the error appears.

How to debug errors that happen deep in the call stack?

Trace backward from the immediate cause by asking what called each function and what values were passed. Add stack trace instrumentation with console.error before the failing operation to capture the full call chain and identify the original trigger.

What is defense-in-depth validation in debugging?

Defense-in-depth validation adds checks at every layer data passes through: entry point validation, business logic validation, environment guards, and debug instrumentation. This makes the bug structurally impossible rather than fixed at a single bypassable point.

When should I stop trying fixes and rethink the approach?

Stop after three or more failed fix attempts and question whether the underlying architecture or pattern is fundamentally sound. Repeated failures indicate the hypothesis is wrong or the design itself needs reconsideration, not another quick patch.

Why do bug fixes keep failing even after multiple attempts?

Fixes fail repeatedly when they address symptoms instead of root causes, or when multiple variables change at once. Form a single hypothesis, test it with the smallest possible change, and verify the result before forming a new hypothesis.