systematic-debugging

Enforces a four-phase, root-cause debugging workflow across production and test failures.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/Canepro/codex-skills --skill systematic-debugging-canepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Canepro/codex-skills/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/Canepro/codex-skills --skill systematic-debugging-canepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Core Features & Use Cases

  • Phase-driven, disciplined debugging workflow that ensures root-cause analysis and validated fixes
  • Provides a defense-in-depth approach to catch issues across multiple layers
  • Works across production, staging, and development environments with repeatable processes

Quick Start

Follow the four-phase debugging process: read errors, reproduce reliably, gather evidence, then complete Phase 1 before proposing fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a root-cause debugging workflow and when should I use it?

A root-cause debugging workflow is a disciplined, phase-driven process that identifies the underlying cause of bugs before any fixes are proposed. You should use it when encountering any unexpected behavior, test failure, or production bug.

How do I systematically debug a test failure instead of applying quick fixes?

To systematically debug a test failure, follow the four-phase process: read errors, reproduce reliably, gather evidence, and establish a single clear hypothesis with root-cause evidence before proposing any fixes.

What's the best way to investigate unexpected behavior in production environments?

The best way to investigate unexpected behavior is to enforce a repeatable engineering process across production, staging, and development environments that requires minimal testing and defense-in-depth validation before closure.

Does the defense-in-depth debugging approach work across staging and development environments?

Yes, the defense-in-depth debugging approach works across production, staging, and development environments, applying a repeatable process to catch issues across multiple layers before validating and closing fixes.

When should I not use a phase-driven debugging process?

You should avoid using a phase-driven debugging process when a quick fix is explicitly sufficient, as this workflow requires completing root-cause evidence gathering and forming a single clear hypothesis before closure.