debugging-discipline

Guide engineers through falsifiable hypothesis debugging for root-cause analysis.

Updated May 4, 2026
One-click install
npx skills add https://github.com/xaionaro/.config-codex --skill debugging-discipline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-discipline
Source: https://github.com/xaionaro/.config-codex/tree/main/skills/debugging-discipline
Command: npx skills add https://github.com/xaionaro/.config-codex --skill debugging-discipline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Supplements systematic-debugging with additional rigor.

Mitigation is not a fix: lowering failure probability is containment until the cause chain is repaired. Require explicit causality: trigger -> mechanism -> failure -> repaired link. Any missing link means keep investigating.

Core Features & Use Cases

  • RCA loop discipline: Gather evidence, inspect the failing path, and state an informed RCA hypothesis that is falsifiable.
  • Repro and logging discipline: Keep a minimal, fast repro and log changes after each probe, logging, or fix to verify progress.
  • Live/prod safety gating and bisect guidance: Establish anchors and route prod-only validations only when cheaper proofs are insufficient.

Quick Start

Reproduce the issue with a minimal, fast repro before investigating and log evidence after every probe.

Frequently Asked Questions about debugging-discipline

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

FAQPage Schema
How do I improve root-cause analysis when debugging complex software failures?

Root-cause analysis improves by forming falsifiable hypotheses that require explicit causality from trigger to mechanism to failure. You must gather evidence and inspect the failing path to state an informed hypothesis before applying fixes.

What is a falsifiable hypothesis in debugging and incident response?

A falsifiable hypothesis in debugging is a proposed root cause that can be proven invalid through controlled experiments and evidence. It enforces explicit causality where any missing link between trigger and failure means investigation continues.

How do I create a minimal reproduction loop for investigating intermittent issues?

Create a minimal, fast reproduction before investigating and log evidence after every probe. Keep the repro loop fast and log changes after each fix to verify progress and maintain investigation discipline.

Why does lowering failure probability not fix the root cause during incident response?

Lowering failure probability is mitigation, not a root-cause fix. Mitigation acts as containment until the full cause chain is repaired, requiring explicit validation of trigger, mechanism, failure, and the repaired link.

When should I run live production validations during root-cause analysis?

Route prod-only validations only when cheaper proofs are insufficient. Establish anchors and apply safety gating to ensure live validations are necessary and controlled within the RCA loop.

Does this debugging approach work for QA workflows and software incident response?

Yes, the approach applies to software debugging, incident response, and QA workflows. It requires reproducible repro steps, logging, evidence collection, and structured review to drive testable fixes across these environments.