systematic-debugging

Guide software engineers through a four-phase debugging protocol with audit trail.

1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/busboom-software-studio/design-trainer --skill systematic-debugging-busboom-software-studio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/busboom-software-studio/design-trainer/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/busboom-software-studio/design-trainer --skill systematic-debugging-busboom-software-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A structured debugging protocol that replaces ad hoc fix attempts by guiding engineers through a repeatable workflow.

Core Features & Use Cases

  • Four-phase methodology: evidence gathering, pattern analysis, hypothesis testing, and root-cause fix.
  • Three-attempt cap with escalation to prevent wasted effort and ensure accountability.
  • Audit trail that records evidence, hypotheses, tests, and resolutions for traceability.

Quick Start

Begin a debugging session by collecting evidence and formulating hypotheses before implementing changes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a structured debugging workflow for fixing failing tests?▼

A structured debugging workflow replaces ad hoc fix attempts by guiding software engineers through a repeatable four-phase protocol: evidence gathering, pattern analysis, hypothesis testing, and root-cause fix to resolve failing tests.

How do I find the root cause of a software regression?▼

To find the root cause of a software regression, follow a structured methodology of gathering evidence, analyzing patterns, and testing hypotheses before implementing a fix, ensuring you address the actual source rather than symptoms.

What is the best way to stop wasting time on ad hoc debugging?▼

The best way to stop wasting time on ad hoc debugging is to enforce a three-attempt cap with escalation, preventing endless trial-and-error and ensuring accountability when initial hypothesis testing fails to resolve the issue.

How do I maintain an audit trail during root-cause analysis?▼

You maintain an audit trail during root-cause analysis by using a structured protocol that automatically records all gathered evidence, tested hypotheses, and final resolutions, providing full traceability for your debugging sessions.

When should I escalate a failing test during hypothesis testing?▼

You should escalate a failing test during hypothesis testing after reaching the three-attempt cap, a structured limit designed to prevent wasted effort and trigger accountability for further debugging escalation.

Can I use this structured debugging protocol for any code change regression?▼

Yes, you can use this structured debugging protocol for any code change regression, as the four-phase evidence gathering and hypothesis testing methodology is applicable across projects for software engineers debugging various failures.