systematic-debugging

Diagnose bugs through structured root-cause investigation with evidence gathering and hypothesis testing.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/jacardl/New-Radar --skill systematic-debugging-jacardl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/jacardl/New-Radar/tree/main/backend/frameworks/hermes-agent/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/jacardl/New-Radar --skill systematic-debugging-jacardl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging is often time-consuming and error-prone; this skill enforces a four-phase, root-cause-centric approach to investigate and understand failures before proposing fixes.

Core Features & Use Cases

  • Phase-driven investigation: root-cause analysis, pattern analysis, hypothesis testing, and controlled implementation.
  • Audit-ready: provides traceable evidence, checkpoints, and completion checklists for reliable debugging.
  • Use Case: when a flaky test fails or a production bug appears, follow the four phases to identify the root cause and validate fixes before deployment.

Quick Start

Reproduce the issue and read the error messages, then trace data flow and identify the root cause following Phase 1 before attempting 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 flaky test failure?

Find the root cause of a flaky test failure by reproducing the issue and tracing data flow during the root-cause investigation phase before proposing any fixes. This structured approach enforces evidence gathering and pattern analysis to identify the true source.

What is a systematic debugging process for production bugs?

A systematic debugging process for production bugs applies four phases: root-cause investigation, pattern analysis, hypothesis testing, and controlled implementation. It ensures you understand failures through evidence and checkpoints before safely applying fixes.

How do I debug performance regressions without introducing new issues?

Debug performance regressions safely by forming hypotheses, testing them methodically, and validating fixes with regression checks during the implementation phase. This controlled approach prevents new issues by validating that fixes address the actual root cause.

Does systematic root-cause debugging work for integration issues across different services?

Systematic root-cause debugging works for integration issues across software projects and teams. It applies structured evidence gathering and hypothesis testing to diagnose runtime errors, performance regressions, and unexpected behavior consistently.

What's the best way to fix runtime errors instead of just patching symptoms?

The best way to fix runtime errors instead of patching symptoms is following a four-phase root-cause investigation. It enforces evidence gathering, hypothesis formation, and completion checklists to ensure your fixes address the actual failure mechanism.