qualia-debug

What problem does it solve?

Provides a structured, repeatable debugging workflow so engineers can gather accurate symptoms, confirm diagnoses with users, and apply minimal verified fixes rather than guessing.

Core Features & Use Cases

• Symptom gathering: Guided questions to capture exact errors, expected behavior, start time, and attempts made.
• Diagnosis confirmation: Present a clear diagnosis before any code changes and wait for user confirmation to avoid incorrect fixes.
• Investigate, isolate, and fix: Stepwise reproduction, binary search isolation, root-cause identification, minimal patching, verification, and commit.
• Modes: Interactive mode for general debugging, frontend mode for CSS/layout issues, and perf mode for profiling and hot-path optimization.
• Use Cases: Fixing a layout overflow in a web app, tracking down a backend exception, or diagnosing a slow page load and applying targeted performance improvements.

Quick Start

Use the qualia-debug skill interactively by describing the observed error, the expected behavior, what you have tried, and which mode (frontend or perf) to use.