systematic-debugging

Guide software debugging through root cause investigation, hypothesis testing, and fix implementation.

190|18|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/havingautism/Codemini-CLI --skill systematic-debugging-havingautism
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/havingautism/Codemini-CLI/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/havingautism/Codemini-CLI --skill systematic-debugging-havingautism

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new bugs. Quick patches mask underlying issues.

Core principle: ALWAYS find root cause before attempting fixes. Symptom fixes are failure.

Core Features & Use Cases

  • Root Cause Investigation: Read error messages carefully, reproduce reliably, and trace data flow to locate the origin of the issue.
  • Pattern Analysis: Compare with references, identify differences, and understand dependencies to differentiate symptoms from causes.
  • Hypothesis & Testing: Form a single hypothesis, test minimally with controlled changes, and validate results before moving forward.
  • Implementation: Create minimal failing tests when possible, apply the fix, and verify complete issue resolution with safeguards.

Quick Start

Begin with Phase 1 by gathering error details, reproducing the issue, and tracing data flow to identify the root cause before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and how does it find root causes?

Systematic debugging is a structured process that enforces root cause identification before fixes. It traces data flow and reproduces issues reliably to locate origins, ensuring symptom patches do not mask underlying problems.

How do I debug test failures or production bugs step by step?

Debug test failures or production bugs using a four-phase process: investigate root cause, analyze patterns, form and test a single hypothesis minimally, then implement the fix with safeguards and verify complete resolution.

Can I use this systematic debugging process for performance problems and multi-component interactions?

Yes, systematic debugging applies to any software issue, including performance problems and multi-component interactions. It guides you to read errors carefully, trace data flow, and compare with references across diverse technical contexts.

Why do random fixes waste time and create new bugs?

Random fixes waste time and create new bugs because they address symptoms rather than root causes. Applying quick patches masks underlying issues, leading to incomplete resolution and potential regressions in the software.

What's the best way to validate a debugging hypothesis before applying fixes?

Validate a debugging hypothesis by forming a single hypothesis, testing it minimally with controlled changes, and verifying results before moving forward. Create minimal failing tests when possible to confirm the root cause accurately.

When should I use defense-in-depth practices during software investigation?

Use defense-in-depth practices during the implementation phase of software investigation. Apply these optional diagnostics and safeguards after root cause confirmation to verify complete issue resolution and prevent future regressions.