git:20260513.58e49a6 to git:20260513.f998546

2 added, 11 removed. Audit A to A.

---

name: bug-capture

- description: Preserve discovered bugs in BUGS.md with reproduction and verification.

+ description: Preserve discovered bugs as durable BUGS.md entries with reproduction steps, expected behavior, hypothesis, status, verification, and resolution.

---

# Bug Capture

## Purpose

Preserve discovered bugs as durable 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

- - Resolution if fixed

+ - `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.