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.