systematic-debugging

Enforce a four-phase systematic debugging process to resolve root causes.

30|2|Updated Mar 3, 2022
One-click install
npx skills add https://github.com/lie5860/ak-guess --skill systematic-debugging-lie5860
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/lie5860/ak-guess/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/lie5860/ak-guess --skill systematic-debugging-lie5860

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic debugging guides engineers to identify root causes before proposing fixes, reducing wasteful symptom-focused patches.

Core Features & Use Cases

  • Four-phase framework (root-cause investigation, pattern analysis, hypothesis testing, implementation) with explicit rules and anti-patterns.
  • Diagnostic references and defense-in-depth guidance to prevent regressions.
  • Works across test failures, production incidents, and abnormal system behavior, ensuring reproducible investigations.

Quick Start

Read the four-phase framework and begin with Phase 1: root-cause investigation.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic debugging process for finding root causes?

A systematic debugging process enforces a formal four-phase framework to identify root causes before proposing fixes, reducing wasteful symptom-focused patches for bugs and incidents.

How do I debug test failures systematically instead of patching symptoms?

Debug test failures systematically by following the four-phase framework: root-cause investigation, pattern analysis, hypothesis testing, and implementation, ensuring you resolve underlying issues rather than applying patches.

What are the debugging anti-patterns that cause regressions?

Debugging anti-patterns include skipping phases of the systematic framework to apply quick fixes. Enforcing mandatory phase completion and anti-shortcut safeguards prevents these regressions during root-cause resolution.

Can this systematic debugging framework work for production incidents?

Yes, this systematic debugging framework works for production incidents, test failures, and abnormal system behavior, guiding engineers through diagnostic references and defense-in-depth guidance to ensure reproducible investigations.

What is the best way to resolve abnormal system behavior without guessing?

The best way to resolve abnormal system behavior is enforcing hypothesis testing and pattern analysis within the four-phase systematic debugging framework, ensuring you verify root causes before implementation.

When should I use a formal debugging framework instead of quick fixes?

Use a formal debugging framework when facing complex test failures or production incidents where symptom-focused patches are wasteful, enforcing root-cause investigation and anti-shortcut safeguards to prevent future regressions.