systematic-debugging

Apply a four-phase debugging workflow to identify root causes before fixes.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/AlejandroFigini/artist-portfolio --skill systematic-debugging-alejandrofigini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/AlejandroFigini/artist-portfolio/tree/main/.agent/skills/systematic-debugging
Command: npx skills add https://github.com/AlejandroFigini/artist-portfolio --skill systematic-debugging-alejandrofigini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a structured, four-phase workflow to uncover root causes before proposing fixes, reducing wasted effort and rework.

Core Features & Use Cases

  • Phase-driven investigation: Root Cause Investigation, Pattern Analysis, Hypothesis, and Implementation with guardrails.
  • Encourages defense-in-depth practices and documentation to prevent regression.
  • Use cases include debugging failures, flaky tests, performance regressions, and production incidents.

Quick Start

Follow Phase 1: reproduce the issue, collect evidence, and identify root cause before attempting any fix.

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 before attempting a fix?

To find the root cause, apply a four-phase debugging workflow that enforces reproducing the issue and collecting evidence before attempting any fixes. This prevents wasted effort on symptoms.

What is the best way to debug flaky tests and performance regressions?

The best way to debug flaky tests and performance regressions is applying a systematic four-phase workflow: root cause investigation, pattern analysis, hypothesis, and guarded implementation to prevent future regression.

How does systematic debugging prevent recurring production incidents?

Systematic debugging prevents recurring production incidents by enforcing root cause identification before fixes and promoting defense-in-depth practices with documentation to stop regression.

Can I use this debugging workflow for test failures and performance issues?

Yes, you can use this debugging workflow for test failures and performance issues. It applies a phase-driven investigation encompassing root cause analysis, pattern identification, and hypothesis validation.

Why should I complete root cause investigation before implementing a code fix?

You should complete root cause investigation before implementing a code fix because the workflow enforces Phase 1 completion to reduce wasted effort and rework caused by addressing symptoms instead of underlying causes.

What are the limitations of fixing symptoms without pattern analysis?

Fixing symptoms without pattern analysis limits your ability to apply defense-in-depth practices. Skipping the structured four-phase debugging workflow increases rework and fails to prevent future regressions.