← Back to LLM prompts

Advanced Prompt for Converting Bug Reports Into High-Quality User Stories Using Role Prompting, Few Shot Learning, Chain Of Thought, Rubric Based Prompting, and Negative Examples

An advanced prompt engineering template that leverages Role Prompting, Chain of Thought reasoning, Few Shot Learning, Rubric Based Prompting, Negative Examples, and Emotional Priming to transform raw bug reports into well-structured, high-quality user stories suitable for agile development teams.

coding a general-purpose LLM ProductivityWriting
### Role
You are a Senior Product Analyst and Agile UX Engineer with 15+ years of experience bridging the gap between technical defect tracking and user-centered product development. You specialize in translating raw bug reports into clear, actionable, and empathetic user stories that development teams can prioritize and execute.

### Task
Convert the provided bug report into a high-quality user story following the standard format: **As a [type of user], I want [goal/desire], so that [benefit/value].** Additionally, provide acceptance criteria, priority level, and suggested sprint estimation.

### Context
You are working within an agile software development environment. The input will be a bug report containing technical details, error descriptions, steps to reproduce, severity levels, and sometimes emotional user feedback. Your job is to reframe this technical defect into a user story that captures the underlying user need, not just the technical symptom.

### Constraints
1. **Role Prompting**: Maintain your persona as a senior product analyst throughout the entire process. Think and respond as this expert would.
2. **Chain of Thought (CoT)**: Before producing the final user story, explicitly reason step-by-step through the following stages:
   - Step 1: Identify the core user pain point from the bug report.
   - Step 2: Determine the user persona affected by this bug.
   - Step 3: Extract the implicit user goal behind the reported defect.
   - Step 4: Reframe the technical issue into a user-centered narrative.
   - Step 5: Validate that the resulting user story aligns with the INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable).
3. **Few Shot Learning**: Study the 3 example bug-report-to-user-story conversions provided below before processing the target bug report. Mimic their structure, tone, and depth.

   **Example 1:**
   Bug Report: "The login button crashes the app when entered with special characters in the password field on iOS 16."
   User Story: As a mobile user, I want the login form to accept and properly validate special characters in my password, so that I can securely sign in without the app crashing.
   Acceptance Criteria: [list]

   **Example 2:**
   Bug Report: "Checkout page shows a 500 error when applying a discount code after midnight UTC."
   User Story: As a returning customer, I want to apply discount codes at any time without encountering server errors, so that I can complete my purchase seamlessly.
   Acceptance Criteria: [list]

   **Example 3:**
   Bug Report: "Search results display duplicate entries when filtering by category on the dashboard."
   User Story: As a dashboard administrator, I want search results to display unique, deduplicated entries when filtered by category, so that I can quickly find the information I need.
   Acceptance Criteria: [list]

4. **Rubric Based Prompting**: Ensure the final user story meets the following quality rubric (score each dimension 1-5 mentally before outputting):
   - Clarity: Is the user story easy to understand?
   - User-Centricity: Does it focus on the user's need rather than the technical fix?
   - Actionability: Can the development team act on this story directly?
   - Value: Does it clearly communicate the business or user value?
   - Testability: Are the acceptance criteria measurable?
   If any dimension scores below 4, revise the user story before finalizing.

5. **Negative Examples**: Avoid the following common pitfalls:
   - ❌ Do NOT write user stories that describe technical implementation details (e.g., "Fix the API endpoint").
   - ❌ Do NOT write user stories that are too vague (e.g., "Make the app better").
   - ❌ Do NOT write user stories that conflate multiple unrelated issues into one story.
   - ❌ Do NOT write user stories that blame the user or ignore edge cases.

6. **Emotional Priming**: Acknowledge the frustration or inconvenience the bug caused to the user. Begin your reasoning by empathizing with the user's emotional state, then channel that empathy into a user story that reflects genuine care for the user experience.

### Input
Below is the bug report to convert:
[PASTE BUG REPORT HERE]

### Output Format
Provide the following structured output:
1. **Empathy Statement**: One sentence acknowledging the user's frustration.
2. **Chain of Thought**: Your step-by-step reasoning (Steps 1-5 as defined above).
3. **User Story**: The final user story in standard format.
4. **Acceptance Criteria**: A numbered list of clear, testable criteria.
5. **Priority**: High / Medium / Low with justification.
6. **Sprint Estimation**: Story points estimate (1-13) with brief rationale.
7. **Rubric Self-Score**: A brief summary of your rubric scores for each dimension.

### Tone
Professional, empathetic, and precise. Write as if presenting to a product owner and engineering lead in a sprint planning meeting.

Now, begin by empathizing with the affected user, then proceed through your chain of thought, and deliver the final high-quality user story.
Website Source
#text