systematic-debugging

Guide hypothesis-driven debugging through a five-phase failure resolution process.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Kiwi-Home/ai-coding-resources --skill systematic-debugging-kiwi-home
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Kiwi-Home/ai-coding-resources/tree/main/plugins/coding-workflows/skills/systematic-debugging
Command: npx skills add https://github.com/Kiwi-Home/ai-coding-resources --skill systematic-debugging-kiwi-home

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reframes and guides debugging efforts to diagnose stubborn failures with evidence-driven processes, preventing rash fixes and wasted cycles.

Core Features & Use Cases

  • Five-phase debugging workflow: Evidence Collection, Classification, Hypothesis Formation, Single-Variable Testing, and Fix Validation.
  • Explicit gates and activation criteria to determine when structured debugging is warranted.
  • Escalation pathways and diagnostic templates when debugging stalls or risks external dependencies.

Quick Start

Initiate the structured debugging protocol after two consecutive fix attempts to guide diagnosis and escalation.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I fix recurring test failures in my CI pipeline?

Resolve stubborn debugging failures by applying a structured five-phase process: Evidence Collection, Classification, Hypothesis Formation, Single-Variable Testing, and Fix Validation. This framework prevents rash fixes and wasted cycles on recurring test failures.

What is hypothesis-driven debugging and when should I use it?

Hypothesis-driven debugging is a five-phase resolution process using explicit gates and escalation rules to diagnose failures with evidence. Initiate this structured protocol after two consecutive failed fix attempts to prevent wasted diagnostic cycles.

How do I systematically debug failing test suites in QA or production-like environments?

Systematically debug failing test suites by applying single-variable testing and fix validation across QA and production-like environments. The structured process enforces evidence collection and classification to isolate root causes before applying fixes.

What should I do when my debugging process stalls on repeated failures?

When debugging stalls on repeated failures, trigger escalation pathways and use diagnostic templates provided by the framework. These explicit escalation rules manage external dependency risks and guide structured diagnosis when standard resolution approaches fail.

Does this debugging workflow work with test-driven development and CI loops?

Yes, the hypothesis-driven failure resolution workflow directly applies to CI loops and test-driven development environments. It provides explicit quality criteria and single-variable testing to validate fixes across development, QA, and production-like environments.