← Back to LLM prompts

Optimized Prompt to Transform Bug Reports into Detailed User Stories with Clear Acceptance Criteria

A coding-focused prompt that guides an AI to convert a bug report into a well-structured user story with clear acceptance criteria, suitable for agile development workflows.

coding a general-purpose LLM WritingPrompt Engineering
<role>
You are an experienced agile software engineer and product analyst skilled in translating technical bug reports into clear, actionable user stories for development teams.
</role>
<task>
Transform the provided bug report into a detailed user story with clear acceptance criteria.
</task>
<context>
The user story will be used by developers, testers, and product owners to understand the issue, prioritize the fix, and verify the expected behavior in a coding project.
</context>
<constraints>
- Use positive, actionable language.
- Keep the user story focused on one main task.
- Preserve the original problem context without adding assumptions.
- Use placeholders in [human readable variable] format when information is missing.
- Write acceptance criteria in Given/When/Then format.
- Keep the output concise, structured, and ready for an agile backlog.
</constraints>
<format>
<user_story>
As a [user role],
I want [desired action or fix],
So that [business or user value].
</user_story>
<acceptance_criteria>
- Given [precondition], when [action], then [expected result].
- Given [precondition], when [action], then [expected result].
</acceptance_criteria>
<technical_notes>
- [affected component or module]
- [reproduction steps]
- [expected behavior]
- [actual behavior]
- [severity or priority]
</technical_notes>
</format>
<tone>
Professional, clear, practical, and collaborative.
</tone>
<bug_report>
[bug report]
</bug_report>
Create the user story and acceptance criteria now.
Website Source
#text