systematic-debugging

Identify root causes of bugs through a four-phase debugging process.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/brunoreinstein-cloud/chat-assitjur --skill systematic-debugging-brunoreinstein-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/brunoreinstein-cloud/chat-assitjur/tree/main/.agents/skills/systematic-debugging
Command: npx skills add https://github.com/brunoreinstein-cloud/chat-assitjur --skill systematic-debugging-brunoreinstein-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging guides engineers to locate the root cause of bugs before proposing fixes, reducing wasted time and rework.

Core Features & Use Cases

  • A four-phase framework (Root Cause Investigation → Pattern Analysis → Hypothesis → Implementation) with explicit do-not-skip rules and anti-patterns to prevent shortcuts.
  • Extensive defense-in-depth guidance and practical examples to improve debugging reliability across systems.
  • Real-world usage patterns, checklists, and references that accelerate incident resolution in production and CI environments.

Quick Start

Load the skill and complete Phase 1 to start root-cause investigation 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 a bug before applying a fix?

Finding the root cause of a bug requires a systematic four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation. This framework forces you to trace symptoms to their origin before applying fixes, preventing wasted time and regression.

What is the systematic debugging process for resolving production incidents?

Systematic debugging resolves production incidents through a four-phase framework: Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation. It enforces do-not-skip rules and uses anti-patterns to prevent shortcuts, guiding you from symptom discovery to verified resolution.

How do I prevent regression when fixing bugs in CI environments?

To prevent regression when fixing bugs in CI environments, apply defense-in-depth principles during the Implementation phase of systematic debugging. This approach ensures your root-cause fix is reliable and prevents the same issue from reoccurring across your systems.

What are common anti-patterns to avoid during root-cause tracing?

Common anti-patterns in root-cause tracing include skipping the Root Cause Investigation phase and jumping directly to fixes. Systematic debugging provides explicit anti-patterns and do-not-skip rules to prevent these shortcuts, ensuring you verify hypotheses before implementation.

When should I use hypothesis testing for software debugging?

Use hypothesis testing for software debugging during the third phase of systematic debugging, after completing Root Cause Investigation and Pattern Analysis. It allows you to validate theories against observed symptoms before moving to the Implementation phase, ensuring accurate root-cause identification.

Does this debugging framework work for complex systems with defense-in-depth requirements?

Yes, this debugging framework works for complex systems by emphasizing defense-in-depth to prevent regression. It provides extensive guidance, practical examples, and checklists to improve debugging reliability across systems in production and CI environments.