← ClaudeAtlas

bugfixlisted

Use when a bug is reported, something is broken, an error or crash needs fixing, a wrong output appears, or a regression shows up — guides Grimoire's Reproduce → Root-Cause → failing-test-FIRST → Fix → Verify discipline and will not let the fix begin until a failing regression test is recorded. Use also when the user says "bugfix", "/bugfix", "fix this bug", or "something is broken".
grimoire-rs/grimoire · ★ 7 · AI & Automation · score 77
Install: claude install-skill grimoire-rs/grimoire
# /bugfix — Guided Bug-Fix Workflow Guard rail for the #1 bug-fix failure: **fixing before a failing test exists.** This skill walks [`workflow-bugfix.md`](../../rules/workflow-bugfix.md) (the single source of truth) and adds one hard, non-skippable gate — **Phase 3 must produce a test that fails on the current code before any fix is written.** > Why this exists: the rule alone was repeatedly skipped. This skill makes the > order explicit and the gate blocking. Read `workflow-bugfix.md` for the full > rationale; this file is the executable checklist. ## The non-negotiable sequence ``` Reproduce → Root-Cause Analysis → FAILING TEST → Fix → Verify → Review → Commit ``` Each phase finishes before the next starts. The **only** way past Phase 3 is a test that you have **run** and **watched fail** for the right reason. ## Phase 1 — Reproduce (no guessing) - State the exact wrong behavior: command, input, observed vs expected. - Find the surface: which entry point(s)? CLI command, TUI path, library seam? A bug often lives on more than one surface (e.g. a CLI path AND its TUI twin); list every one that shares the broken code. - Confirm it actually reproduces. If you can't reproduce it, keep digging — **no speculative fixes.** Write a one-line repro: `"<cmd/inputs> → <observed>; expected <expected>"`. ## Phase 2 — Root-Cause Analysis (write it down) - Trace the symptom to the line **and** the condition that made it fire. - Output a root-cause statement in this exact sh