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.