# Bug Capture

> Preserve discovered bugs as BUGS.md entries.

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

---


# Bug Capture

## Purpose

Preserve discovered bugs as artifacts.

## When to use

Use when a bug is found, whether or not it is fixed in the current session.

## Inputs

- Observed behavior
- Expected behavior
- Reproduction steps
- Affected files
- Verification command

## Workflow

1. Create or update `BUGS.md`.
2. Add a bug title.
3. Record observed and expected behavior.
4. Write reproduction steps.
5. List affected files.
6. Add hypothesis and status.
7. Record verification command.
8. Add resolution if fixed.

## Outputs

- `BUGS.md` entry with bug title, observed behavior, expected behavior, reproduction steps, affected files, hypothesis, status, verification command, and resolution if fixed

## Stop conditions

- The bug is captured well enough for another session to reproduce.
- The issue is not a bug and should become a decision or task instead.

## Anti-patterns

- Leaving bug knowledge trapped in chat history.
- Recording "broken" without reproduction steps.
- Closing a bug without verification evidence.