| name | bug-reporting-excellence |
| description | Write high-quality bug reports that get fixed quickly. Use when reporting bugs, training teams on bug reporting, or establishing bug report standards. |
| category | quality-communication |
| priority | high |
| tokenEstimate | 900 |
| agents | ["qe-quality-analyzer","qe-production-intelligence","qe-flaky-test-hunter"] |
| implementation_status | optimized |
| optimization_version | 1 |
| last_optimized | "2025-12-03T00:00:00.000Z" |
| dependencies | [] |
| quick_reference_card | true |
| tags | ["bugs","reporting","communication","triage","quality"] |
| trust_tier | 2 |
| validation | {"schema_path":"schemas/output.json","validator_path":"scripts/validate-config.json"} |
Bug Reporting Excellence
<default_to_action>
When reporting bugs:
- TITLE:
[Component] fails [Condition] causing [Impact]
- DESCRIBE: Expected behavior → Actual behavior → Steps to reproduce
- INCLUDE: Environment, severity, screenshots/logs, business impact
- ISOLATE: Narrow down conditions (browser, user, amount thresholds)
- ONE BUG = ONE REPORT (don't combine issues)
Bug Report Formula:
## [Component] Issue Title
**Severity:** Critical/High/Medium/Low
**Environment:** Production/Staging/Dev
### Expected Behavior
What should happen
### Actual Behavior
What actually happens (with error messages)
### Steps to Reproduce
1. Step one
2. Step two
3. Observe issue
### Impact
How this affects users/business
Critical Success Factors:
- Reproducible steps (100%)
- Environment info (100%)
- Business impact stated (90%)
- Screenshots or logs (80%)
</default_to_action>
Quick Reference Card
Severity Levels
| Level | Definition | Examples |
|---|
| Critical | System down, data loss, security | DB deleted, payments broken, credentials exposed |
| High | Major feature broken, many users | Can't checkout, search broken, dashboard fails |
| Medium | Partial break, workaround exists | Filter broken (refresh works), slow export |
| Low | Cosmetic, rare edge case | Button wraps on mobile, tooltip wrong color |
Title Formula
❌ Bad: "Checkout broken"
✅ Good: "Payment fails with Visa cards when order total > $1000"
Pattern: [Component] fails [Condition] causing [Impact]
Essential Information
Environment Details
Browser: Chrome 120.0.6099.109 (Windows)
OS: Windows 11 Pro
URL: https://example.com/checkout
Date/Time: 2025-10-17 14:23 UTC
User: test@example.com (ID: 12345)
Request ID: abc-123-def-456