verify-first-debugging

What problem does it solve?

This skill provides a structured, six-phase framework to ensure bug fixes are grounded in verified facts rather than assumptions, guiding teams to identify root causes before applying changes.

Core Features & Use Cases

• Phase-driven workflow: Guides six phases (Reproduce & Define Expected, Locate Affected Components, Verify Component Relationships, Verify Prerequisites, Identify Root Cause, Fix At Root) with orchestrated SubAgents and clear handoffs.
• Rigorous evidence chain: Produces phase artefacts, success criteria, and replan logic to ensure traceable, auditable debugging cycles.
• Risk-aware remediation: Emphasizes root-cause fixes over superficial patches and provides rollback-safe workflows in case of missing data.
• Use case: When diagnosing a flaky UI bug, the framework ensures you first confirm the exact expected behavior and reproduction steps, then narrow down the responsible component, before proposing a durable fix.

Quick Start

Begin with Phase 1 to reproduce and define the expected behavior, then advance through Phase 2–6 with phase-specific inputs/outputs and evidence collection.