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.