# Bug Fix Prove It

> Fix bugs by reproducing the failure first, making the smallest correction, and proving the regression is covered. Use for bug reports, failing tests, and regressions.

- Skill: `seemseam/bug-fix-prove-it` (Agent Skill)
- Install (CLI): `npx skillmds@latest add seemseam/bug-fix-prove-it`
- Raw SKILL.md: https://api.skillmd.com/api/skills/seemseam/bug-fix-prove-it/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: seemseam (https://skillmd.com/u/seemseam)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/seemseam/bug-fix-prove-it

---


# Bug Fix Prove-It

Use this skill when the user reports a bug or asks you to fix a failing test.

Read `templates/test-proof.md` for the final evidence report.

## Workflow

1. Restate the bug in observable terms.
2. Reproduce the failure with an existing command, manual steps, or a new test.
3. If reproduction is not possible, explain the proof gap before changing code.
4. Make the smallest fix that addresses the root cause.
5. Run the failing reproduction again and confirm it passes.
6. Run nearby regression checks when shared code was touched.
7. Report the before/after evidence.

## Guardrails

- Do not fix from intuition when a cheap reproduction is available.
- Do not broaden behavior just to make the bug disappear.
- Do not hide the bug with a fallback, catch-all, or default-success response.
- Do not change tests to match incorrect behavior.

## Output

```text
Bug Fix Proof
- bug:
- reproduced with:
- fix:
- verified with:
- residual risk:
```