systematic-debugging

Investigates root causes of software errors through hypothesis-driven, evidence-based analysis.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/duylinhdang1998/claude-template-agent --skill systematic-debugging-duylinhdang1998
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/duylinhdang1998/claude-template-agent/tree/main/plugins/vfm-agent-company/skills/systematic-debugging
Command: npx skills add https://github.com/duylinhdang1998/claude-template-agent --skill systematic-debugging-duylinhdang1998

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps engineers and teams systematically diagnose and prove the root cause of software bugs, test failures, unexpected behavior, performance regressions, and build or integration errors by enforcing an evidence-driven investigation before proposing fixes.

Core Features & Use Cases

  • Four-phase methodology: Root cause investigation, pattern analysis, hypothesis testing, and targeted implementation to avoid symptom-only fixes.
  • Reproducibility and evidence collection: Read full error traces, reproduce reliably, trace data flow, and gather multi-layer evidence across components.
  • Use Case: For an intermittent CI failure in the checkout flow, reproduce the failure, compare with known-good implementations, form a single minimal hypothesis, create a failing test, and then implement and verify a focused fix.

Quick Start

Investigate the intermittent checkout failure by reproducing the steps, tracing where the bad value originates, forming one clear hypothesis, and producing the minimal failing test to validate the root cause.

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 intermittent CI test failures?

To find the root cause of intermittent CI test failures, you must first reliably reproduce the failure, trace the data flow to where the bad value originates, and form a single minimal hypothesis before testing. This approach enforces evidence collection to prevent symptom-only fixes.

What is the best way to debug production incidents and performance regressions?

The best way to debug production incidents and performance regressions is to apply an evidence-driven investigation. This involves reading full error traces, gathering multi-layer evidence across components, and proving the root cause through hypothesis testing before implementing any targeted fixes.

How do I stop fixing symptoms and find the actual root cause of software bugs?

To stop fixing symptoms and find the actual root cause of software bugs, apply a four-phase methodology: root cause investigation, pattern analysis, hypothesis testing, and targeted implementation. This enforces stepwise evidence collection to prove the underlying issue.

Do I need to create a failing test before fixing unexpected runtime behavior?

Yes, you need to create a failing test before fixing unexpected runtime behavior. Creating a failing test validates the root cause hypothesis and ensures your targeted implementation actually resolves the defect without introducing regressions.

How does hypothesis testing work for build or integration errors?

Hypothesis testing for build or integration errors works by forming a single minimal hypothesis after comparing the failing behavior with known-good implementations. You then run targeted tests to validate the root cause before applying a focused fix.

When should I use systematic debugging for software bug triage?

You should use systematic debugging for software bug triage whenever you face production incidents, CI test failures, performance regressions, or build errors where reproducible investigation and concrete evidence are required to determine the true root cause.