| name | bug-capture |
| description | Preserve discovered bugs as BUGS.md entries. |
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
- Create or update
BUGS.md.
- Add a bug title.
- Record observed and expected behavior.
- Write reproduction steps.
- List affected files.
- Add hypothesis and status.
- Record verification command.
- 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.