systematic-debugging

Guide software debugging through four phases before implementing fixes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/NAinfini/Guild_Management --skill systematic-debugging-nainfini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/NAinfini/Guild_Management/tree/main/.kilocode/skills/systematic-debugging
Command: npx skills add https://github.com/NAinfini/Guild_Management --skill systematic-debugging-nainfini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, repeatable approach to debugging that emphasizes root-cause investigation before fixes, preventing symptom-focused patches.

Core Features & Use Cases

  • Four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Anti-patterns and defenses: explicit rules to resist time pressure and avoid shortcuts; defense-in-depth validation across multiple layers.
  • Practical guidance: step-by-step checklists, references to related techniques, and real-world testing scenarios.

Quick Start

Read the skill, then follow Phase 1 to begin root-cause investigation. If under pressure, remind yourself of the anti-patterns to prevent premature fixes, and use Phase 4 only after root cause is established.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is systematic debugging and how does it fix recurring bugs?

Systematic debugging is a four-phase framework enforcing root-cause investigation before remediation. It fixes recurring bugs by preventing symptom-focused patches through rigorous pattern analysis, hypothesis testing, and defense-in-depth validation across software layers.

How do I find the root cause of a production incident?

To find the root cause of a production incident, initiate Phase 1: Root Cause Investigation. You must complete all four phases—investigation, pattern analysis, hypothesis testing, and implementation—before applying fixes to ensure robust outcomes.

What is the best way to stop applying quick patches during time pressure?

The best way to resist time pressure and avoid premature fixes is by applying explicit anti-pattern rules. These defenses enforce completing the root-cause tracing phases first, preventing shortcuts that lead to symptom-focused patches.

Does systematic debugging work for test failures and software bugs?

Yes, systematic debugging applies to software issues ranging from test failures to production incidents. It guides teams through root-cause tracing and defense-in-depth checks, ensuring you establish the root cause before implementing any fixes.

When should I not use a symptom-focused approach for debugging?

You should never use a symptom-focused approach when a bug requires robust remediation. Avoid shortcuts under time pressure; instead, complete all four systematic debugging phases to ensure defense-in-depth validation and prevent recurring failures.