systematic-debugging

Enforce a four-phase debugging workflow with root-cause analysis and verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reproducible, evidence-based debugging that replaces guesswork with a structured, verifiable process for diagnosing and resolving issues quickly.

Core Features & Use Cases

  • Four-phase methodology: Reproduce, Isolate, Understand, and Verify.
  • Root-cause analysis and evidence collection to prevent regression.
  • Applies to complex bugs across multiple environments and large codebases.

Quick Start

Run the four-phase debugging workflow on a failing issue to reproduce, isolate, understand, and verify the fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a structured approach for debugging complex issues across large codebases?

Structured debugging uses a four-phase methodology—reproduce, isolate, understand, and verify—to replace guesswork with evidence-based root-cause analysis. It applies to complex issues across large codebases and multiple environments.

How do I reproduce and isolate a bug to find its root cause?

Follow the four-phase workflow: reproduce the defect reliably, isolate the problematic code using evidence collection, understand the root cause, and verify the fix. Checklists guide each phase to ensure repeatability.

Can I use a systematic debugging workflow for issues spanning multiple environments?

Yes, this systematic debugging methodology is designed for complex bugs across multiple environments and large codebases. It uses evidence collection and validation criteria to ensure safety and repeatability in any environment.

What's the best way to verify a bug fix and prevent regression?

The best way to prevent regression is to apply the verify phase with clear validation criteria. This evidence-based step confirms the root cause is resolved and the fix is safe, preventing future recurrence.

When should I use a checklist-based troubleshooting process instead of ad-hoc debugging?

Use a checklist-based troubleshooting process for complex bugs requiring verifiable root-cause analysis and evidence collection. It enforces a structured, repeatable workflow that prevents regression better than ad-hoc guesswork.