systematic-debugging

Diagnose software defects through root cause analysis before code modification.

14|3|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/kofttlcc/quant-test --skill systematic-debugging-kofttlcc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/kofttlcc/quant-test/tree/main/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/kofttlcc/quant-test --skill systematic-debugging-kofttlcc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs by enforcing a rigorous process to find the root cause of any issue before attempting fixes.

Core Features & Use Cases

  • Root Cause Analysis: Ensures that the underlying reason for a bug, test failure, or unexpected behavior is identified.
  • Systematic Investigation: Guides users through a structured four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Use Case: When a critical test fails in a CI/CD pipeline, this Skill is invoked to meticulously trace the failure back to its origin, preventing superficial fixes that could reintroduce the problem later.

Quick Start

Invoke the systematic-debugging skill to investigate the recent test failure in the user authentication module.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root cause analysis in software debugging and when do I need it?

Root cause analysis in software debugging identifies the underlying reason for a defect before any code modification. You need it when investigating unexpected behaviors, test failures, or architectural flaws to prevent superficial fixes that reintroduce the same problem later.

How do I systematically debug a failing test in my CI/CD pipeline?

Systematically debug a failing test by following a structured four-phase process: gather evidence for root cause investigation, identify patterns, test hypotheses, and implement verified fixes. This methodology traces the failure back to its origin rather than applying immediate patches.

What's the best way to fix a bug without introducing new issues?

The best way to fix a bug without regressions is enforcing a rigorous investigation process that identifies the actual root cause before any code modification. By testing hypotheses and verifying the implementation against gathered evidence, you prevent wasted time and new bugs.

Can I use a structured debugging methodology for architectural flaws and not just minor bugs?

Yes, you can use a structured debugging methodology for architectural flaws, not just minor bugs. The systematic investigation process applies to all software development issues, scaling from minor unexpected behaviors to complex architectural problems through evidence gathering and pattern analysis.

Why does my bug fix keep reintroducing the same problem in my codebase?

Your bug fix keeps reintroducing the problem because the underlying root cause was never identified. Skipping systematic evidence gathering and pattern analysis leads to superficial fixes; enforcing root cause investigation before implementation permanently resolves the defect.