Write a Structured, Actionable Bug Report
Generate a professional bug report with severity justification, numbered reproduction steps, impact analysis, and a one-line regression test case — in the format developers actually want to read.
Who this is for
QA engineers, manual testers, and SDETs who want to write clearer, more actionable bug reports that developers can reproduce and fix without back-and-forth. Especially useful for testers new to structured defect reporting.
Prompt Template
You are a senior QA engineer writing a structured, actionable bug report for a development team.
Defect summary: {{defectSummary}}
Application: {{appName}}
Environment: {{environment}} (OS/browser/version)
User role: {{userRole}}
Build/version: {{buildVersion}}
Generate a complete bug report with all sections below:
---
**Title** — one line maximum, format: "[Component] What fails when condition"
Example: "[Checkout] Order total resets to £0.00 when applying a discount code on mobile Safari"
**Severity**: Critical / High / Medium / Low
_Justification_: explain why this severity level was chosen
**Priority**: Immediate / High / Normal / Low
_Justification_: business impact and user reach
**Steps to Reproduce** (numbered, include exact data used):
1. Step one with exact URL, credentials, or input values
2. ...
**Expected Result**: What the system should do per spec/design
**Actual Result**: What actually happens — include exact error messages, status codes, or UI state
**Root Cause Hypothesis**: Your technical guess at the underlying cause
**Impact Analysis**: Which user journeys, revenue flows, or user segments are affected
**Workaround**: Available workaround if any (or "None")
**Attachments**:
- List specific screenshots, screen recordings, network HAR files, or console logs to attach
**Regression Test** (one-line test case to verify the fix is working):
"Given [state] when [action] then [expected outcome]"
---
Language requirements: factual, concise, zero ambiguity. Every step reproducible by a developer who has never seen this feature. No vague phrases like "it sometimes fails" — quantify everything.How to use this prompt
- 1Copy the prompt and paste into your AI assistant.
- 2Describe the bug you found in plain text as input — environment, what happened, what you expected, and any error messages or screenshots.
- 3The AI generates a fully structured bug report with severity, priority, steps to reproduce, actual vs expected results, environment details, and suggested tags.
- 4Review and edit the generated report — add any specific log lines, screenshots, or network responses you have.
- 5Paste the final report into your bug tracker (Jira, Linear, GitHub Issues, etc.).
Example output
Given 'The checkout button doesn't work when the user applies a coupon code on mobile Safari', the prompt generates a structured report with: Title, Severity (Medium), Priority (High), Environment (iOS 17 / Safari 17), Steps to Reproduce (5 numbered steps), Actual Result, Expected Result, Impact (revenue loss), and suggested labels: [checkout] [mobile] [regression].
Limitations
- The quality of the bug report depends on the quality of your initial description — the more context you provide (environment, user role, data state), the more accurate the output.
- The prompt does not know your bug tracker's custom fields — you may need to map the generated report to your team's specific Jira fields or templates.
Related tools
Related guides
Frequently asked questions
What severity and priority levels does the report use?v
By default, the prompt uses Critical / High / Medium / Low for severity and a 1–4 priority scale. You can specify your team's custom severity model in the input and the prompt will adapt.
Can I use this for API bugs as well as UI bugs?v
Yes — describe the API endpoint, request, and unexpected response in your input and the prompt generates a structured API bug report including request/response snippets.
How do I include screenshots or logs?v
Paste relevant log lines or error messages directly into your description — the prompt will reference them in the report. Attach screenshots manually in your bug tracker after generating the report.