debug-workflow

What problem does it solve?

This Skill provides a structured, functionality-first approach to debugging, ensuring that bug investigations are systematic and focused on restoring broken features. It coordinates investigation skills and delegates to specialized subagents, preventing aimless troubleshooting and leading to faster, evidence-backed resolutions.

Core Features & Use Cases

• Functionality-First Debugging: Prioritizes understanding what functionality is broken (user, admin, system flows) before debugging.
• Systematic Investigation: Enforces a loop of bug-investigator -> code-reviewer -> integration-verifier for comprehensive analysis.
• Evidence-First Verification: Requires logs and failing tests to prove the bug, followed by a fix and GREEN proof.
• Comprehensive Debug Report: Compiles an executive summary, root cause, fix, regression test, and verification summary.
• Use Case: When the orchestrator detects a debug intent for a broken feature, this skill ensures a thorough, systematic debugging process, identifying the root cause, implementing a minimal fix, and verifying the functionality is restored.

Quick Start

Activate the debug-workflow skill to fix the reported bug in the user profile update functionality, starting with reproducing the issue.