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.