systematic-debugging

Diagnose software bugs through four-phase root cause investigation before applying fixes.

3|2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/Yoodaddy0311/artibot --skill systematic-debugging-yoodaddy0311
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/Yoodaddy0311/artibot/tree/main/plugins/artibot/skills/systematic-debugging
Command: npx skills add https://github.com/Yoodaddy0311/artibot --skill systematic-debugging-yoodaddy0311

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Developers often apply quick patches or guess-and-check fixes without understanding why a bug occurred, which masks deeper issues, introduces regressions, and accumulates technical debt. This Skill enforces a disciplined investigation process so every fix addresses the actual root cause. ## Core Features & Use Cases - Four-Phase Debugging Workflow: Reproduce the issue, trace and classify the root cause (logic, state, contract, environment, regression), validate an explicit hypothesis with a failing test, then apply and verify a minimal fix. - Iron Law Enforcement: Blocks any code change until the root cause is identified with evidence, with rationalization tables that counter common excuses for skipping investigation. - Reference Guides: Includes root-cause tracing techniques (git bisect, stack trace analysis, 5 Whys) and defense-in-depth strategies for layered protection against recurring bug classes. - Use Case: When a login endpoint returns a 500 error in CI but works locally, use this Skill to reproduce the failure, trace the execution path, classify it as an environment issue, and ship a verified fix with a regression test. ## Quick Start Ask the AI to debug a specific error, for example: investigate why the auth module throws a TypeError on login and find the root cause before fixing it.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I debug a bug systematically instead of guessing fixes?▼

Follow a four-phase process: reproduce the issue with minimal steps, trace the execution path to classify the root cause, state and validate a hypothesis with a failing test, then apply a minimal fix and verify the full test suite passes.

How to find the root cause of an intermittent test failure?▼

Intermittent failures usually stem from race conditions, timing, or state leaks. Use git bisect to find the introducing commit, add timing assertions or artificial delays, and snapshot state before and after operations to locate the divergence point.

When should I skip full root cause analysis for a bug?▼

Skip the full four-phase investigation only for trivial typos, obvious off-by-one errors visible in a single line, or issues whose root cause is already documented in a prior post-mortem. Deterministic one-character fixes do not need Phase 1-2 overhead.

Why does my bug fix keep causing new regressions?▼

Regressions after fixes usually mean the fix patched a symptom rather than the root cause. Verify the fix includes a reproduction test that fails without it, addresses the classified root cause category, and passes the entire existing test suite.

What should a bug fix include besides the code change?▼

Every fix should include a regression test reproducing the exact bug, documentation of the root cause and fix rationale, and optionally defensive validation at boundaries to prevent the same bug class from recurring.