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.