debugging-systematic

Diagnose bugs through a four-phase root cause analysis framework.

1|Updated Sep 26, 2025
One-click install
npx skills add https://github.com/pascallammers/mylo-travel-concierge-v2 --skill debugging-systematic-pascallammers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-systematic
Source: https://github.com/pascallammers/mylo-travel-concierge-v2/tree/main/.factory/skills/debugging-systematic
Command: npx skills add https://github.com/pascallammers/mylo-travel-concierge-v2 --skill debugging-systematic-pascallammers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework to systematically diagnose the root cause of bugs, test failures, and unexpected behavior, ensuring fixes address the underlying issue rather than just symptoms.

Core Features & Use Cases

  • Root Cause Analysis: Guides users through a four-phase process (Investigation, Pattern Analysis, Hypothesis Testing, Implementation) to understand why an issue occurs.
  • Debugging Techniques: Offers practical methods like binary search, differential debugging, instrumentation, and rubber duck debugging.
  • Common Root Causes: Highlights frequent pitfalls such as race conditions, shared mutable state, incorrect assumptions, off-by-one errors, and timezone issues.
  • Use Case: When a critical bug is reported in production, this Skill helps engineers move beyond guesswork to a scientific, evidence-based approach for rapid and reliable resolution.

Quick Start

Use the debugging-systematic skill to apply the four-phase framework to investigate the intermittent authentication failure.

Frequently Asked Questions about debugging-systematic

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

FAQPage Schema
How do I systematically find the root cause of a bug?

Systematic root cause analysis uses a four-phase framework—reproduction, evidence gathering, hypothesis testing, and implementation—to diagnose bugs. This approach ensures you fix the underlying issue rather than just treating symptoms.

What is the best way to debug intermittent race conditions?

Debugging race conditions requires systematic evidence gathering and instrumentation to capture timing dependencies. The framework highlights shared mutable state and incorrect assumptions as frequent pitfalls to investigate during hypothesis testing.

How do I use binary search and differential debugging to fix test failures?

Binary search and differential debugging are techniques applied during the hypothesis testing phase to isolate variables. They help systematically narrow down code changes or environmental factors causing unexpected behavior or test failures.

When should I use a systematic debugging approach instead of guessing?

Use a systematic debugging approach when critical bugs are reported in production or when guesswork fails. It provides a scientific, evidence-based methodology to rapidly and reliably resolve unexpected behavior and complex test failures.

Can this debugging methodology handle shared mutable state issues?

Yes, the debugging methodology specifically addresses shared mutable state issues. It guides engineers through pattern analysis and instrumentation to identify concurrency pitfalls and incorrect assumptions causing unexpected behavior.