systematic-debugging

Diagnose root causes of bugs through a four-phase investigation workflow.

6|3|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/alo-exp/silver-bullet --skill systematic-debugging-alo-exp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/alo-exp/silver-bullet/tree/main/forge/skills/systematic-debugging
Command: npx skills add https://github.com/alo-exp/silver-bullet --skill systematic-debugging-alo-exp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging helps teams avoid patching symptoms and ensures root cause investigations before fixes.

Core Features & Use Cases

  • Phase-based, four-step process guiding bug investigation, pattern analysis, hypothesis testing, and controlled implementation.
  • Supports evidence gathering, reproducibility checks, and traceable diagnostics across single-component and multi-component systems.
  • Real-world scenario: identify and fix the root cause of intermittent failures in a CI/CD pipeline with minimal blast radius.

Quick Start

Begin Phase 1 by describing the failure, reproducing it reliably, and gathering evidence to identify the root cause.

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 software bugs before applying fixes?

Root cause debugging requires documenting a structured four-phase workflow: investigating the failure, analyzing patterns, testing hypotheses, and implementing controlled fixes. This ensures you diagnose root causes before proposing changes.

What is the best way to diagnose intermittent test failures in a CI/CD pipeline?

Diagnosing intermittent CI/CD pipeline failures requires evidence gathering, reproducibility checks, and traceable diagnostics across multi-component systems to identify patterns and verify hypotheses with minimal blast radius.

How do I systematically debug production bugs and performance problems?

Systematic debugging of production bugs and performance problems involves a phase-based process starting with reliably reproducing the failure and gathering evidence to guide root cause investigation.

Can I use structured debugging for build errors and integration glitches?

Yes, structured debugging applies to build errors and integration glitches by enforcing reproducibility and evidence gathering to trace failures across single-component and multi-component systems.

Why does patching symptoms fail to resolve unexpected software failures?

Patching symptoms fails because it skips root cause investigation, leading to recurring failures. A structured debugging workflow enforces evidence gathering and hypothesis testing before implementation to prevent this.

How do I start the root cause investigation process for a software failure?

Start root cause investigation in Phase 1 by describing the failure, reproducing it reliably, and gathering evidence to identify the underlying cause before moving to pattern analysis.