systematic-debugging

Diagnose root causes through a four-phase debugging workflow.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/mnsgrosa/skills --skill systematic-debugging-mnsgrosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/mnsgrosa/skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/mnsgrosa/skills --skill systematic-debugging-mnsgrosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a disciplined, phase-driven approach to diagnose bugs, ensuring root causes are found before any fixes are attempted, reducing wasted time and rework.

Core Features & Use Cases

  • Enforces a four-phase workflow (Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, Implementation) to prevent symptom fixes.
  • Includes anti-pattern awareness and defense-in-depth techniques to guard against shortcuts under pressure.
  • Applicable to any technical issue such as test failures, production bugs, or performance problems, across multi-component systems.

Quick Start

Follow Phase 1 through Phase 4 in order before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic root-cause debugging and why is it necessary for multi-component systems?

Systematic root-cause debugging is a phased approach to identify the underlying origin of bugs before attempting fixes, preventing superficial symptom patches in complex multi-component systems. It enforces discipline through a four-phase workflow to reduce rework.

How do I debug test failures and production bugs without applying symptom fixes?

To debug test failures and production bugs without applying symptom fixes, follow a strict four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This ensures you verify the root cause before proposing any fixes.

Can I use a phased debugging workflow for high-pressure scenarios and collaborative decision-making?

Yes, you can use a phased debugging workflow for high-pressure scenarios and collaborative decision-making. It includes anti-pattern awareness and defense-in-depth practices to prevent shortcuts and ensure reliable, auditable resolutions under pressure.

What is the best way to trace root causes across multi-component technical issues?

The best way to trace root causes across multi-component technical issues is to enforce a structured workflow that isolates the root cause first. By applying pattern analysis and hypothesis testing, you prevent premature fixes and ensure reliable resolutions.

When should I avoid shortcuts in debugging and what are the limitations of ad-hoc fixes?

You should avoid shortcuts in debugging whenever facing complex production bugs or performance problems. Ad-hoc fixes often address only symptoms, leading to recurring failures; applying defense-in-depth practices prevents this and delivers auditable resolutions.