systematic-debugging

Guide engineers through six-phase debugging to identify and prove root causes.

3|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/sami-abdul/claude-predev-setup --skill systematic-debugging-sami-abdul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/sami-abdul/claude-predev-setup/tree/main/scaffold/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/sami-abdul/claude-predev-setup --skill systematic-debugging-sami-abdul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging complex failures by guiding engineers through a rigorous, six-phase runbook to uncover root causes before proposing fixes.

Core Features & Use Cases

  • Phase-driven investigation with explicit reproduction, evidence collection, and hypothesis testing.
  • Guardrails to prevent premature fixes and ensure verifiable root-cause articulation.
  • Applicable to failing tests, runtime errors, and production incidents across software projects and CI pipelines.

Quick Start

Follow the six-phase runbook on a failing issue to systematically identify the root cause before proposing a solution.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for finding the root cause of software failures?

Systematic debugging is a rigorous, six-phase runbook that guides engineers through reproduction, evidence collection, and hypothesis testing to uncover and prove the root causes of software failures before proposing fixes.

How do I debug a failing test in my CI pipeline without jumping to premature fixes?

You can debug a failing test in your CI pipeline by following a phase-driven investigation runbook that enforces evidence gathering, explicit hypothesis testing, and verifiable root-cause articulation with guardrails to prevent premature fixes.

How do I investigate unexpected runtime errors and production incidents systematically?

To investigate unexpected runtime errors and production incidents systematically, follow a structured six-phase runbook that enforces documented phases, explicit reproduction, and evidence gathering to prove the root cause before resolving the issue.

Can I use a phase-driven debugging runbook for any software engineering project?

Yes, you can use a phase-driven debugging runbook for any software engineering project, as it applies broadly to failing tests, unexpected runtime errors, and production incidents across diverse software projects and CI pipelines.

Why does my debugging process fail to identify the true root cause of a failure?

Your debugging process may fail to identify the true root cause if it lacks guardrails to prevent premature fixes, structured evidence gathering, and formal hypothesis testing to verify the root-cause articulation before applying a solution.