Profile My skills Saved Collections Edit profile Submit a skill

Bug Capture

Preserve discovered bugs as BUGS.md entries.

tmusser a34d6cc 1.1 KB Updated
Coding & Dev Tools

File contents

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.

tmusser/ai-engineering-skills/tree/main/skills/bug-capture commit a34d6cceee

Browse category

Frequently asked questions

npx skillmds@latest add tmusser/bug-capture