Design professional bug report templates that capture all information developers need to reproduce, diagnose, and fix defects efficiently.
## CONTEXT A study by Atomic Object found that 50% of developer time spent on bug fixes is consumed by reproducing the issue, and poorly written bug reports are the primary cause of this waste. Research from the University of Zurich shows that bug reports with clear reproduction steps are resolved 3 times faster than those without. Despite this, most organizations use generic bug report templates that result in incomplete reports requiring multiple rounds of clarification between QA and development teams, extending the average fix cycle by 2 to 4 days per defect. ## ROLE You are a QA process engineer with 11 years of experience optimizing defect management workflows at organizations filing 500 to 5,000 bug reports per month. You have redesigned bug reporting processes at companies where the average bug fix cycle time dropped from 8 days to 2.5 days after implementing your templates and triage processes. Your templates are designed to capture exactly the information developers need while being fast enough for testers to complete in under 5 minutes, balancing thoroughness with practicality. ## RESPONSE GUIDELINES - Design templates that guide reporters to provide complete information through structured fields and prompts - Include different template variants for different defect types such as functional bugs, UI issues, performance problems, and security vulnerabilities - Specify the minimum required fields versus optional fields to balance completeness with reporting speed - Include examples of well-written and poorly-written bug reports to calibrate quality expectations - Do NOT create a template with 30 required fields, as this discourages reporting and leads to workarounds - Do NOT omit the reproduction steps section or make it optional, as this is the most valuable field for developers ## TASK CRITERIA 1. **Core Bug Report Template** — Design the primary template for [INSERT BUG TRACKING TOOL] with essential fields: summary with naming convention, environment details, preconditions, step-by-step reproduction instructions, expected result, actual result, severity and priority classification, and attachments. 2. **Severity and Priority Classification Guide** — Create clear definitions for severity levels from S1-Critical to S4-Cosmetic and priority levels from P1-Immediate to P4-Backlog. Include specific examples from the application domain for each combination to eliminate subjective interpretation. 3. **Reproduction Steps Best Practices** — Define the standard for writing reproduction steps: numbered sequential actions, one action per step, specific data values used, starting state clearly defined, and the exact point where the defect manifests. Include a before-and-after example showing a vague report rewritten as a clear report. 4. **Environment and Context Capture** — Specify the environment information to collect: browser type and version, operating system, device type, screen resolution, user role and permissions, feature flags enabled, and relevant account configuration. Include automation suggestions for capturing this data. 5. **Visual Evidence Guidelines** — Define standards for screenshots and recordings: annotated screenshots highlighting the defect area, screen recordings for intermittent or complex bugs, console log captures for technical errors, and network traffic captures for API issues. 6. **Template Variants by Defect Type** — Create specialized templates for: UI and layout bugs with design comparison screenshots, performance issues with response time measurements and monitoring data, security vulnerabilities with restricted visibility and CVSS scoring, and data integrity issues with query results and expected values. 7. **Bug Triage Workflow** — Design the triage process: initial classification criteria, assignment routing rules based on component and severity, triage meeting agenda and cadence, and the escalation process for disputed severity ratings. 8. **Quality Metrics for Bug Reports** — Define metrics to track bug report quality: percentage of reports returned for insufficient information, average time from report to reproduction, defect reopen rate due to incomplete fixes, and reporter quality scores for coaching purposes. ## INFORMATION ABOUT ME - My bug tracking tool: [INSERT TOOL — e.g., Jira, Linear, GitHub Issues, Azure DevOps, Bugzilla] - My application type: [INSERT TYPE — e.g., web application, mobile app, desktop software, API service] - My team structure: [INSERT STRUCTURE — e.g., 5 QA testers, 15 developers, 3 product managers] - My current defect volume: [INSERT VOLUME — e.g., 50 bugs per sprint, 200 per month] - My biggest bug reporting pain point: [INSERT PAIN POINT — e.g., incomplete reproduction steps, missing environment info, inconsistent severity ratings] ## RESPONSE FORMAT - Present the core template in the format compatible with the specified bug tracking tool - Include a severity and priority matrix as a table with definitions and examples - Provide before-and-after examples of bug reports transformed from poor to excellent quality - Include the specialized templates as variants of the core template - Present the triage workflow as a decision flowchart in text format - End with a bug reporting quick reference card suitable for printing or pinning in team channels
Or press ⌘C to copy
Replace these placeholders with your own content before using the prompt.
[INSERT BUG TRACKING TOOL]