mav-systematic-debugging

Identify root causes through a structured four-phase debugging workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and address root causes before proposing fixes in software debugging to reduce wasted effort and rework.

Core Features & Use Cases

  • Phase-driven debugging that enforces a four-phase workflow: Root Cause Investigation, Pattern Analysis, Hypothesis and Test, and Fix and Verify, with escalation when needed.
  • Provides a clear, repeatable method for diagnosing issues across test failures, build errors, and unexpected behaviour in multi-component systems.
  • Includes guidance for documenting findings and ensuring changes address root causes rather than symptoms.

Quick Start

Begin with Phase 1: collect logs, reproduce the failure, and document root-cause evidence before proposing fixes.

Frequently Asked Questions about mav-systematic-debugging

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

FAQPage Schema
What's the best way to identify the root cause of software bugs?

Systematic debugging identifies root causes of software bugs by enforcing a structured four-phase process: root cause investigation, pattern analysis, hypothesis testing, and fix verification. This prevents wasted effort treating symptoms instead of core issues.

How do I debug test failures and build errors systematically?

To debug test failures and build errors systematically, start with Phase 1: collect logs, reproduce the failure, and document root-cause evidence. Then proceed through pattern analysis and hypothesis testing before implementing and verifying your fix.

How can I troubleshoot integration issues across APIs and dependencies?

Troubleshoot integration issues across APIs and dependencies by applying a phase-driven debugging workflow that enforces root cause investigation, pattern analysis, hypothesis testing, and fix verification with escalation rules for complex multi-component systems.

Why should I investigate root causes before proposing fixes during debugging?

Investigating root causes before proposing fixes during debugging reduces wasted effort and rework. The structured process ensures you document evidence and verify that changes address the actual underlying problem rather than superficial symptoms.

Can I use a structured debugging workflow for unexpected behavior in multi-component systems?

Yes, this structured debugging workflow is designed for diagnosing unexpected behavior in multi-component systems. It provides a clear, repeatable method with escalation rules and documentation guidance to handle complex interactions across codebases, APIs, and dependencies.