← ClaudeAtlas

reproduce-first-debuglisted

Debug a defect under a hard reproduce-first gate — no hypothesis, code reading, or fix before a reproduction artifact fails. The reproduction is promoted to a permanent regression test, committed RED before the fix, then logged to a bug ledger. Uses local fixtures, never real ticket or production data. Use this skill when a defect lacks a confirmed root cause, or the user says "debug this", "fix this bug", "why is X broken", "this is failing", "the test is red", "investigate this error", "find the root cause", "debugge das", "warum geht das nicht", "das funktioniert nicht", "finde den Fehler", "such den Bug", "der Test ist rot", "Fehler analysieren". Also trigger when a stack trace, failing test output, or error log is pasted without a question. DO NOT trigger for a known cause where only the fix is wanted, for adding tests to working code, or for reviewing a diff — use `branch-review` for that. NOT for general debugging without the RED-repro-and-ledger gate — see `superpowers:systematic-debugging`.
lx-wnk/skills · ★ 1 · Code & Development · score 71
Install: claude install-skill lx-wnk/skills
# Reproduce-First Debugging Force a failing reproduction before any hypothesis, then keep that reproduction forever as a regression test. ## Scope Covers defect investigation from report to logged root cause: gathering trigger data, building a reproduction artifact, bisecting the broken layer boundary, and promoting the reproduction to a permanent test. Does **not** cover: implementing features, reviewing diffs, performance profiling without a functional defect, or fixing a defect whose root cause is already confirmed and evidenced — in that case go straight to the fix. ## Examples ```bash /reproduce-first-debug Promotion code is ignored on the cart page for bundled products ``` ```bash /reproduce-first-debug ABC-1234 ``` ```bash # Also triggers on a bare paste, with no question attached: /reproduce-first-debug TypeError: Cannot read properties of undefined (reading 'total') at CartSummary.vue:42 ``` ## Workflow ```mermaid flowchart TD A[1. Collect trigger data] -->|complete| B[2. Build reproduction artifact] A -->|input missing| A1[Ask for the specific input. STOP.] B -->|artifact fails reproducibly| C[3. Bisect the layer boundary] B -->|cannot reproduce, input missing| A1 B -->|cannot reproduce, inputs present, attempts < 3| B B -->|cannot reproduce after 3 attempts, inputs present| B1[Not reproducible locally. Record attempted vectors, hand back: instrumentation or prod trace. STOP.] C --> D[4. Promote to regression test, commit RED]