systematic-debugging

Guide engineers through a four-phase root cause debugging process.

2|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/magicappdev/magicappdev --skill systematic-debugging-magicappdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/magicappdev/magicappdev/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/magicappdev/magicappdev --skill systematic-debugging-magicappdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging provides a disciplined, four-phase approach to debugging that ensures you identify the root cause before proposing any fixes, reducing symptom-driven churn.

Core Features & Use Cases

  • Four-Phase Process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation guide every debugging effort.
  • Prevention over Patching: Emphasizes confirming root cause to avoid regressing into new issues.
  • Wide Applicability: Useful for bugs, test failures, production incidents, performance problems, and integration issues across any tech stack.
  • Anti-pattern Awareness: Explicitly documents shortcuts to avoid.

Quick Start

Load the systematic-debugging skill (skills/debugging/systematic-debugging) and begin with Phase 1: Root Cause Investigation, following its checklist before attempting any fixes.

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 a bug instead of just applying quick patches?

To find the root cause of a bug, you must follow a four-phase systematic debugging process: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This enforces confirmation of the actual issue before proposing fixes.

What is the best way to debug production incidents and performance issues across different tech stacks?

The best way to debug production incidents and performance issues across any tech stack is applying a systematic debugging methodology. It guides engineers through pattern analysis and hypothesis testing to prevent symptom-driven churn.

How do I investigate test failures without introducing new regressions?

You investigate test failures by completing a Root Cause Investigation phase before attempting any fixes. This prevention-over-patching approach confirms the exact failure mechanism, ensuring your implementation avoids regressing into new issues.

Why does my debugging process result in repeated symptom-driven churn?

Your debugging process results in symptom-driven churn because fixes are proposed before identifying the root cause. Applying systematic debugging enforces a four-phase process that requires completing hypothesis testing before implementation.

Can I use systematic debugging for integration problems across any platform?

Yes, you can use systematic debugging for integration problems across any platform. It provides a disciplined, tech-stack-agnostic approach that documents anti-patterns to avoid and ensures root cause confirmation.

When should I avoid shortcut methods during root cause investigation?

You should avoid shortcut methods during root cause investigation whenever you face bugs, test failures, or performance issues. Systematic debugging explicitly documents these anti-patterns to prevent incomplete fixes and regressions.