vibe-fix-buglisted
Install: claude install-skill aakashdhar/vibe-skill
# Vibe Fix Bug Skill
Spec-driven bug diagnosis and surgical fixing.
Diagnosis before fix. Regression test before fix code. Smallest possible change.
**Use Plan Mode (Shift+Tab) for Steps 1–5. Exit before Step 6.**
> **Autonomous / headless mode.** At startup resolve the settings with
> `python3 ~/.claude/skills/vibe-mode/scripts/vibe_state.py mode`. If `vibe_mode` is
> `autonomous`, every "wait", "ask", "confirm" and approval step in this skill follows
> vibe-mode's `references/HEADLESS.md` §2 instead: take the recommended option, accept your
> own draft after one self-check, log each choice to `vibe/DECISIONS.md`, never ask the
> user, and stop — writing `vibe/.run_state.json` — only when a person is genuinely required.
---
## The O'Reilly principles this enforces
**Spec before code** — root cause confirmed and fix plan approved before any code changes.
**Context preservation** — CODEBASE.md read first, ARCHITECTURE.md patterns followed.
**Incremental verifiable progress** — regression test first, fix second, verify third.
**Drift prevention** — DECISIONS.md updated, ARCHITECTURE.md updated if fix reveals new pattern.
---
## Two audiences. Two file types.
**Human-facing:**
- `vibe/TASKS.md` — plain English, updated after every task
**Agent-facing (human never opens these):**
- `vibe/bugs/[date-slug]/BUG_SPEC.md` · `BUG_PLAN.md` · `BUG_TASKS.md`
- `vibe/CODEBASE.md` · `vibe/ARCHITECTURE.md` · `vibe/DECISIONS.md`
---
## Step 1 — Gather the bug report and triage sev