systematic-debugging

Enforce a four-phase workflow to identify root-cause bugs and failures.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams identify and fix bugs by enforcing a rigorous, four-phase debugging workflow that prioritizes root-cause analysis over quick symptom fixes.

Core Features & Use Cases

  • Four-Phase Framework: Phase 1 Root Cause Investigation, Phase 2 Pattern Analysis, Phase 3 Hypothesis & Testing, Phase 4 Implementation.
  • Anti-patterns & Guardrails: Clear avoidance of shortcuts like "fix symptom first" and built-in defenses (STOP and re-analyze, defense-in-depth).
  • Practical Guidance & References: Includes root-cause tracing, defense-in-depth, and documented best practices with real-world impact.

Quick Start

Load the skill and follow Phases 1 through 4 in order to identify and fix the root cause before proposing changes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root-cause debugging and how does a four-phase workflow help fix software failures?

Root-cause debugging identifies the underlying cause of software failures rather than just addressing symptoms. A four-phase workflow enforces systematic investigation, pattern analysis, hypothesis testing, and implementation to prevent recurring issues.

How do I debug flaky tests without just fixing the symptoms?

To debug flaky tests without fixing symptoms, follow a structured root-cause investigation workflow. Analyze failure patterns, form hypotheses about the underlying cause, and validate fixes through defense-in-depth testing before implementation.

What is the best way to trace incident response symptoms to their underlying cause?

The best way to trace incident response symptoms to their underlying cause is applying a phased debugging workflow. It enforces root-cause tracing and pattern analysis before proposing changes, ensuring time-critical incidents are resolved correctly.

Can I use systematic debugging for time-critical production incidents?

Yes, systematic debugging applies to time-critical production incidents by enforcing a rigorous four-phase workflow. It prioritizes root-cause analysis over quick symptom fixes while integrating defense-in-depth validation to ensure stability.

When should I stop analyzing and re-evaluate during root-cause investigation?

You should stop and re-analyze during root-cause investigation when anti-patterns like attempting to fix symptoms first emerge. Built-in guardrails enforce re-evaluation to ensure the actual underlying cause is identified before implementation.

Does defense-in-depth validation work alongside root-cause tracing in software engineering?

Yes, defense-in-depth validation works alongside root-cause tracing by ensuring implemented fixes are robust against future failures. It validates the four-phase debugging workflow outputs and documents best practices with real-world impact.