systematic-debugging

Guide hypothesis-driven debugging through a 4-phase process using observability tools.

10|2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/bugrabilge/bilge-development-kit --skill systematic-debugging-bugrabilge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/bugrabilge/bilge-development-kit/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/bugrabilge/bilge-development-kit --skill systematic-debugging-bugrabilge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured, hypothesis-driven methodology to systematically identify and resolve complex bugs, performance bottlenecks, and production incidents, preventing guesswork and ensuring thorough root cause analysis.

Core Features & Use Cases

  • Structured Debugging: Guides users through a 4-phase process (Reproduce, Isolate, Understand, Fix & Verify).
  • Hypothesis-Driven Analysis: Encourages forming and testing specific hypotheses with evidence.
  • Observability & Production Safety: Integrates with observability tools and outlines production-safe debugging techniques.
  • Use Case: When a critical bug appears in production that is difficult to reproduce locally, this Skill will guide the AI through analyzing logs, traces, and metrics to pinpoint the root cause without introducing further instability.

Quick Start

Use the systematic-debugging skill to help diagnose a production issue that started after the last deployment.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is a systematic approach to root cause analysis for production incidents?

Production debugging requires a 4-phase methodology: Reproduce, Isolate, Understand, and Fix & Verify. This hypothesis-driven approach leverages observability tools and production-safe techniques to identify root causes without guesswork.

How do I debug complex performance bottlenecks that are difficult to reproduce locally?

Debug complex performance bottlenecks by forming and testing specific hypotheses against observability data. Analyze distributed traces, logs, and APM metrics to isolate the issue without needing local reproduction.

Can I diagnose production issues safely without introducing further instability?

Yes, you can diagnose production issues safely by applying production-safe debugging techniques. This methodology relies on analyzing existing observability data like logs and traces to pinpoint causes without introducing further instability.

What observability tools do I need for effective troubleshooting?

Effective troubleshooting requires understanding error tracking, APM, distributed tracing, and logging aggregation. These observability tools provide the necessary evidence to test hypotheses and perform thorough root cause analysis.

When should I use a hypothesis-driven debugging methodology?

Use a hypothesis-driven debugging methodology when facing complex bugs or critical incidents that resist immediate resolution. It prevents guesswork by ensuring every step is validated with evidence from logs, metrics, and traces.