systematic-debugging

Identify root causes of bugs using a four-phase debugging methodology.

Updated Sep 25, 2024
One-click install
npx skills add https://github.com/kwam1na/athena --skill systematic-debugging-kwam1na
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/kwam1na/athena/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/kwam1na/athena --skill systematic-debugging-kwam1na

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging prevents rash, symptom-based fixes by ensuring root-cause investigation precedes any changes.

Core Features & Use Cases

  • Four-phase methodology (Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation)
  • Defensive rules like "NEVER fix the symptom" and "STOP and re-analyze" to resist pressure
  • Suitable for bugs, test failures, production incidents, and performance/build issues

Quick Start

Follow the four-phase framework to investigate a failing test and identify the root cause before implementing any fixes.

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 when should I use it?

Systematic debugging is a phase-based methodology to identify root causes before fixes. Use it for software bugs, test failures, production incidents, and performance issues to prevent symptom-based patches.

How do I find the root cause of a failing test?

To find the root cause of a failing test, follow a four-phase methodology: gather evidence, analyze patterns, test hypotheses, and implement safely. This ensures you resolve the actual failure, not just the symptom.

What's the best way to investigate production incidents without fixing symptoms?

The best way to investigate production incidents is using defensive rules like "NEVER fix the symptom" and "STOP and re-analyze." This enforces evidence gathering and hypothesis testing to ensure root-cause resolution.

Does root-cause tracing work for build and performance issues?

Yes, root-cause tracing works for build and performance issues. The methodology applies phase-based pattern analysis and hypothesis testing to systematically identify and resolve the underlying faults.

How to stop developers from applying symptom fixes during bug investigation?

Stop symptom fixes during bug investigation by enforcing a four-phase framework with defensive rules. Mandate evidence gathering and hypothesis testing before implementation to ensure root-cause-first resolution.

What are the limitations of a phase-based debugging methodology?

The limitation of phase-based debugging is the resistance to immediate fixes, requiring full evidence gathering and hypothesis testing before implementation. This methodical approach may slow down urgent symptom mitigation under pressure.