---

name: bug-report description: Log a bug report. Use when user asks to create, log, file, or report a bug. allowed-tools: Write, Read, Glob, Task

Bug Report Skill

Create bug reports in DevPlans/Bugs/ following the project's bug tracking conventions.

Investigation First

Before writing the bug report, launch an Explore subagent using the Task tool to investigate the bug thoroughly:

CopyTask tool with subagent_type: "Explore"
model: "opus"
prompt: "Investigate [bug description]. Find:
- All code paths that could cause this behavior
- Related systems and their interactions
- Any existing comments or TODOs about this issue
- Similar patterns elsewhere that work correctly
- Potential root causes based on code analysis"

Use the investigation results to fill in the Root Cause, Affected Code, and Potential Solutions sections with concrete findings rather than speculation.

File Naming

{STATUS}-{BugName}.md

New bugs should always start with OPEN-.

Required Sections

Copy# Bug: {Title}

## Summary
Brief description of the issue.

## Symptoms
- Observable behaviors
- Error messages
- Performance impacts

## Root Cause
Technical explanation of why this happens (if known).

## Affected Code
- List relevant files and line numbers
- `path/to/file.cs:123`

## Potential Solutions
### 1. Solution Name
Description of approach, tradeoffs.

### 2. Alternative
Another option if applicable.

## Priority
Low / Medium / High / Critical

## Related Files
- `path/to/related/file.cs`

Example

For a bug about slow rendering:

• File: DevPlans/Bugs/OPEN-SlowChunkRendering.md
• Title: # Bug: Slow Chunk Rendering
• Include profiling data if available

Status Changes

When a bug is fixed or rejected, rename the file:

• OPEN-MyBug.md → FIXED-MyBug.md
• OPEN-MyBug.md → REJECTED-MyBug.md