phase-gated-debugging

Guide software debugging through five phases with root cause confirmation before fixes.

Updated Jun 25, 2026
One-click install
npx skills add https://github.com/z1439527767/claude-config --skill phase-gated-debugging-z1439527767
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-gated-debugging
Source: https://github.com/z1439527767/claude-config/tree/main/skills/imported/phase-gated-debugging
Command: npx skills add https://github.com/z1439527767/claude-config --skill phase-gated-debugging-z1439527767

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents rushed debugging fixes by enforcing a disciplined investigation process that confirms the real root cause before any source code changes are made.

Core Features & Use Cases

  • Five-Phase Debugging Protocol: Guides agents through reproduction, isolation, root cause analysis, fixing, and verification in a controlled sequence.
  • Confirmation Checkpoints: Requires user agreement on the root cause before applying fixes, reducing incorrect assumptions and repeated failed attempts.
  • Use Case: Help investigate intermittent failures, regressions, crashes, incorrect outputs, or performance issues while maintaining a clear evidence-based debugging trail.

Quick Start

Use the phase-gated-debugging skill to investigate this bug, identify the root cause first, and wait for my confirmation before applying any fix.

Frequently Asked Questions about phase-gated-debugging

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

FAQPage Schema
How do I prevent premature code changes during software debugging?

Prevent premature code changes during software debugging by applying a five-phase investigation protocol that requires root cause confirmation checkpoints before implementing any fixes.

What is the best way to investigate intermittent failures and crashes?

The best way to investigate intermittent failures and crashes is using a phased debugging workflow that guides you through reproduction, isolation, and root cause analysis to maintain an evidence-based diagnostic trail.

How do I perform root cause analysis for regressions and incorrect outputs?

Perform root cause analysis for regressions by following a controlled sequence of diagnostic logging practices and isolation techniques, pausing for root cause confirmation before implementing any fix.

Can I use phase-gated debugging for performance investigations?

Yes, you can use phase-gated debugging for performance investigations because it applies disciplined debugging workflows with post-fix verification procedures to systematically confirm root causes before edits.

Does systematic debugging work without confirming the root cause first?

Systematic debugging does not work effectively without confirming the root cause first, because skipping confirmation checkpoints leads to incorrect assumptions, repeated failed attempts, and rushed fixes.