systematic-debugging

Investigate root causes through a structured 4-phase debugging workflow.

38|12|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/databrickslabs/coding-agents-databricks-apps --skill systematic-debugging-databrickslabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/databrickslabs/coding-agents-databricks-apps/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/databrickslabs/coding-agents-databricks-apps --skill systematic-debugging-databrickslabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random, unplanned bug fixes waste hours of developer time, introduce new defects, and never address the underlying root cause of issues, leading to repeated failures and team thrashing especially under time pressure.

Core Features & Use Cases

  • 4-Phase Structured Workflow: Step-by-step process covering root cause investigation, pattern analysis, hypothesis testing, and implementation to ensure no fixes are attempted before the core issue is understood.
  • Pressure-Resistant Guardrails: Explicit "iron law" rules and mandatory checkpoints designed to prevent shortcuts during emergencies, time crunches, or when quick fixes seem obviously easy.
  • Anti-Pattern Guidance: Clear list of common rationalizations (e.g., "just a quick fix", "skip investigation for simple bugs") and explicit red flags to stop and follow the process.
  • Supporting Techniques: Includes ready-to-use methods for backward root cause tracing, condition-based waiting to eliminate flaky tests, and defense-in-depth validation to make bugs structurally impossible. Ideal for production outages, flaky test failures, multi-component integration bugs, and any scenario where previous quick fixes have failed to resolve the issue long-term.

Quick Start

Use the systematic-debugging skill to investigate the root cause of the failing payment processing test before proposing any fixes.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of flaky tests instead of just fixing symptoms?

A structured debugging workflow addresses production outages by enforcing pressure-resistant guardrails and mandatory checkpoints. These rules prevent shortcuts during emergencies, ensuring you trace the root cause before implementing any fix.

What is the best way to debug production outages under time pressure?

A structured debugging workflow addresses production outages by enforcing pressure-resistant guardrails and mandatory checkpoints. These rules prevent shortcuts during emergencies, ensuring you trace the root cause before implementing any fix.

How do I stop repeating the same bug fixes in multi-component integration bugs?

To stop repeating bug fixes in multi-component integration bugs, apply backward root cause tracing to identify the underlying issue. Defense-in-depth validation then makes the bug structurally impossible to reoccur.

Why do quick fixes often introduce new defects during bug fixing?

Quick fixes introduce new defects because they bypass root cause investigation and rely on symptom-focused patching. Anti-pattern guidance identifies rationalizations like "just a quick fix" as red flags to stop and follow the structured process.

When should I use defense-in-depth validation for bug fixing?

Use defense-in-depth validation during the implementation phase of bug fixing to make resolved bugs structurally impossible. It serves as a supporting technique after root cause tracing and hypothesis testing are complete.

Can this debugging workflow handle performance problems and integration errors?

Yes, this debugging workflow handles performance problems and integration errors. It applies to all technical issue scenarios including test failures and production bugs, providing a structured process for any complex debugging scenario.