debug-workflow

Coordinate specialist debugger agents through a structured five-step evidence-gathering workflow.

453|34|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/josstei/maestro-orchestrate --skill debug-workflow-josstei
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-workflow
Source: https://github.com/josstei/maestro-orchestrate/tree/main/plugins/maestro/skills/debug-workflow
Command: npx skills add https://github.com/josstei/maestro-orchestrate --skill debug-workflow-josstei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging investigation-heavy software issues like intermittent production failures or hard-to-reproduce bugs is often disorganized, leading to missed root causes and wasted time tracking irrelevant code paths.

Core Features & Use Cases

  • Structured 5-Step Workflow: Guides users through establishing failing behavior, forming hypotheses, gathering evidence, isolating root causes, and verifying fixes.
  • Specialist Agent Coordination: Automatically engages the dedicated debugger agent and pulls relevant architecture and delegation context to support analysis.
  • Use Case: When a payment processing service throws random timeout errors, use this skill to systematically trace the execution path, gather log and code evidence, and pinpoint the exact line causing the failure.

Quick Start

Use the debug-workflow skill to investigate the intermittent 500 errors in the user authentication service.

Frequently Asked Questions about debug-workflow

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

FAQPage Schema
How do I structure root cause analysis for intermittent production failures?

Structure root cause analysis for intermittent production failures by applying a 5-step evidence-gathering workflow. This process establishes failing behavior, forms hypotheses, gathers evidence, isolates root causes, and verifies fixes to systematically pinpoint the exact failure.

What is the best way to trace execution paths for hard-to-reproduce software bugs?

The best way to trace execution paths for hard-to-reproduce software bugs is using a structured investigation workflow. This approach coordinates specialist debugger agents and pulls relevant architecture context to support accurate root cause identification across complex codebases.

How do I investigate random timeout errors in a payment processing service?

Investigate random timeout errors in a payment processing service by systematically tracing the execution path. Use a structured debugging workflow to gather log and code evidence, which will pinpoint the exact line causing the intermittent failure.

Can I use a structured debugging workflow for incident response?

Yes, you can use a structured debugging workflow for incident response. It addresses inefficient ad-hoc debugging of complex software issues by coordinating specialist debugger agents and pulling relevant delegation context to support accurate analysis.

Why does ad-hoc debugging lead to missed root causes in complex software issues?

Ad-hoc debugging leads to missed root causes because it is often disorganized, resulting in wasted time tracking irrelevant code paths. Enforcing a structured evidence-gathering process ensures systematic isolation of the actual failure point.