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.