systematic-debugging

Apply a four-phase debugging framework to identify and resolve root causes.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/chokky-education/science-club-web --skill systematic-debugging-chokky-education
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/chokky-education/science-club-web/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/chokky-education/science-club-web --skill systematic-debugging-chokky-education

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill prevents the common pitfall of wasting time on symptom-based patches and random guessing, which often introduce new bugs and mask underlying issues.

Core Features & Use Cases

  • Root Cause Mandate: Enforces a strict four-phase process (Investigation, Pattern Analysis, Hypothesis, Implementation) to ensure the actual source of a bug is addressed.
  • Evidence-Based Debugging: Provides techniques for tracing data flow, adding diagnostic instrumentation, and implementing defense-in-depth validation.
  • Use Case: When a production API fails intermittently, use this skill to systematically trace the error through the call stack and add multi-layer validation to make the failure structurally impossible.

Quick Start

Activate the systematic-debugging skill to begin a rigorous investigation of the current test failure or production bug.

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 when should I use it?

Systematic debugging is a structured framework to identify and resolve the root cause of technical issues. Use it when facing test failures, production bugs, or complex system errors to avoid symptom-based patches and random guessing.

How do I debug an intermittent production API failure?

To debug an intermittent production API failure, use a four-phase process: investigate the error, analyze patterns, form hypotheses, and implement fixes. Trace the error through the call stack and add multi-layer validation to make the failure structurally impossible.

What's the best way to find the root cause of a software bug instead of just patching symptoms?

The best way to find the root cause of a software bug is applying evidence-based debugging. This involves tracing data flow, adding diagnostic instrumentation, and verifying architecture through a strict investigation, pattern analysis, hypothesis, and implementation protocol.

Does this debugging framework work for complex system errors and test failures?

Yes, this debugging framework works for complex system errors and test failures. It applies systematic investigation, hypothesis testing, and architectural verification protocols to software development scenarios involving intermittent production bugs and intricate call stack issues.

Why does symptom-based debugging often introduce new bugs?

Symptom-based debugging introduces new bugs because it masks underlying issues through random guessing and superficial patches. A systematic root-cause-first framework prevents this by enforcing evidence-based investigation and defense-in-depth validation before implementation.

How do I start systematic debugging for a current test failure?

To start systematic debugging for a current test failure, activate the skill to begin a rigorous investigation. It enforces a four-phase process of investigation, pattern analysis, hypothesis testing, and implementation to resolve the root cause.