spec-gen-debug

What problem does it solve?

Debugging in large codebases is slow and error-prone when engineers or agents browse files speculatively without architectural context. This Skill anchors root-cause analysis in spec-gen's structural knowledge so investigators form a falsifiable hypothesis before reading source, reducing wasted exploration and guiding minimal, test-backed fixes.

Core Features & Use Cases

• Orient & Prioritize: Uses spec-gen orient to surface candidate functions, domains, and call paths related to a reported symptom.
• Hypothesis-First Workflow: Requires an explicit, falsifiable hypothesis based on structural traces before reading code, preventing speculative edits.
• Scoped Fix + RED/GREEN Verification: Guides minimal edits, enforces writing a failing test first, verifies the fix passes and runs the full suite, and triggers spec drift checks and invariant documentation.
• Spec Maintenance: Appends discovered invariants to domain specs or records cross-cutting antipatterns to prevent future recurrence.

Quick Start

Use the spec-gen-debug skill to investigate a reproducible bug by providing reproduction steps, project root, expected and observed behaviour, then run the hypothesis-first debugging workflow.