systematic-debugging

Enforce a four-phase root-cause investigation for software bugs.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/photonics-dhl/Hermes --skill systematic-debugging-photonics-dhl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/photonics-dhl/Hermes/tree/main/hermes-home/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/photonics-dhl/Hermes --skill systematic-debugging-photonics-dhl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detecting and resolving bugs quickly by following a disciplined, four-phase root-cause investigation process before attempting fixes, reducing guesswork and rework.

Core Features & Use Cases

  • Phase-based debugging framework that enforces thorough error reading, reproducibility, evidence gathering, and data-flow tracing.
  • Ready-to-follow playbook for developers tackling test failures, production bugs, and integration issues.
  • Can be delegated to a subagent workflow or integrated with test-driven development to ensure regression safety.

Quick Start

Run the four-phase systematic-debugging process on the current issue to identify root causes before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic root-cause debugging process for software?▼

Systematic debugging enforces a four-phase root-cause investigation workflow covering error reading, reproducibility checks, evidence gathering, and data-flow tracing. This structured approach identifies exact failure points before fixes, minimizing guesswork and rework.

How do I debug failing tests and production issues using a structured workflow?▼

Debug failing tests and production issues by following a four-phase playbook: gather evidence, verify reproducibility, trace data-flow, and implement fixes with regression testing guidance. This structured workflow applies across development, CI, and deployment environments to resolve unexpected software behavior.

Can I use this systematic debugging process for CI pipeline failures and deployment issues?▼

Yes, the systematic debugging process applies to test failures, production bugs, and integration issues across development, CI, and deployment environments. It specifies a structured workflow with mandatory evidence gathering and regression testing guidance tailored for these contexts.

What's the best way to stop guessing and find the root cause of unexpected software behavior?▼

The best way to find a root cause is enforcing a disciplined investigation before proposing fixes. By gathering evidence, verifying reproducibility, and tracing data-flow through a four-phase process, you eliminate guesswork and avoid the rework caused by patching symptoms.

Does this debugging workflow support test-driven development and subagent delegation?▼

Yes, the debugging workflow can be delegated to a subagent workflow or integrated with test-driven development. This integration ensures regression safety by enforcing evidence gathering and providing regression testing guidance after resolving the root cause.

Why should I gather evidence and check reproducibility before fixing a bug?▼

Gathering evidence and checking reproducibility before fixing a bug ensures you target the actual root cause rather than symptoms. This four-phase investigation prevents superficial patches, reduces rework, and establishes reliable conditions for subsequent regression testing.