systematic-debugging

Trace root causes of software bugs before proposing fixes.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/JKhyro/HERMES-AGENT --skill systematic-debugging-jkhyro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/JKhyro/HERMES-AGENT/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/JKhyro/HERMES-AGENT --skill systematic-debugging-jkhyro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you avoid guesswork when debugging by forcing a structured investigation before any fix, reducing thrashing and preventing symptom-only patches.

Core Features & Use Cases

  • Root-cause first workflow for bugs, test failures, build issues, performance problems, and unexpected behavior.
  • Four-phase process covering investigation, pattern analysis, hypothesis testing, and implementation.
  • Strong guardrails for reproducibility, evidence collection, regression testing, and architectural escalation after repeated failures.

Quick Start

Use the systematic-debugging skill to investigate this failing test, trace the root cause, and recommend the smallest valid fix after evidence is collected.

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 failing tests and production bugs?▼

To find the root cause of failing tests and production bugs, you need a structured debugging workflow that gathers evidence, traces data flows, and validates hypotheses before proposing a fix.

What is the best way to debug recurring defects across multi-component systems?▼

The best way to debug recurring defects across multi-component systems is applying hypothesis-driven validation and pattern analysis to trace data flows, preventing symptom-only patches and reducing thrashing.

How do I troubleshoot performance regressions and build breaks without guessing?▼

To troubleshoot performance regressions and build breaks without guessing, follow a four-phase investigation process covering error reading, evidence collection, change review, and reproducible test validation.

Can I use systematic debugging for integration issues and unexpected behavior?▼

Yes, you can use systematic debugging for integration issues and unexpected behavior, as it applies hypothesis-driven validation and architectural escalation to diagnose problems across multi-component systems.

When should I escalate debugging efforts for repeated software test failures?▼

You should escalate debugging efforts for repeated software test failures when evidence gathering, change review, and hypothesis testing fail to resolve the issue, triggering architectural escalation guardrails.