Generate User Stories and Acceptance Criteria
Expert guidance for turning requirements into structured, sprint-ready user stories with testable acceptance criteria.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Transform high-level requirements into well-structured user stories and acceptance criteria, following agile best practices to streamline sprint planning and development.
Outcomes
What it gets done
Generate user stories in the standard 'As a... I want... So that...' format.
Create detailed acceptance criteria using the Given-When-Then structure.
Categorize stories into functional, non-functional, or technical types.
Estimate story points and assign MoSCoW priorities.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-user-story-generator | bash Overview
User Story Generator
Expertise in agile user story creation and requirements engineering: standard As-a/I-want/So-that story format, Given-When-Then acceptance criteria, MoSCoW prioritization, Fibonacci story points, and story-splitting techniques, checked against the INVEST criteria. Use when converting requirements into structured, sprint-ready user stories with testable acceptance criteria and sizing; not needed outside an agile backlog process.
What it does
Expert in agile development methodologies, user story creation, and requirements engineering, transforming high-level requirements, features, or business needs into well-structured, actionable user stories that follow industry best practices for effective sprint planning. Follows the standard "As a [user type/persona] / I want [functionality/goal] / So that [business value/benefit]" format, with an enhanced template adding a title (50 characters max), Given-When-Then acceptance criteria, MoSCoW priority (Must have, Should have, Could have, Won't have), Fibonacci story points (1, 2, 3, 5, 8, 13, 21), and dependency tracking.
When to use - and when NOT to
Use this when converting requirements or feature requests into structured user stories, writing Given-When-Then acceptance criteria, sizing stories with story points, splitting oversized stories, or organizing stories into epics for sprint planning.
Not needed for tasks that aren't part of an agile backlog, such as a one-off internal script, or for teams that don't use a story-point/MoSCoW-based planning process.
Inputs and outputs
Given a feature or requirement description, produces a complete user story: title, standard-format description, Given-When-Then acceptance criteria, MoSCoW priority, Fibonacci story points, and dependencies. Story categories covered include functional stories (feature implementation, user interactions, data processing, integration requirements), non-functional stories (performance, security, accessibility, scalability), and technical stories (infrastructure setup, refactoring, technical debt, DevOps).
### US-001: User Registration
**As a** new visitor to the platform
**I want** to create an account with my email and password
**So that** I can access personalized features and save my preferences
### Acceptance Criteria
**AC1: Valid Registration**
Given I am on the registration page
When I enter a valid email, strong password, and confirm password
Then my account should be created successfully
And I should receive a confirmation email
And I should be redirected to the welcome page
Integrations
Story sizing follows a Fibonacci point reference (1 point: simple UI changes or minor bug fixes; 2: basic CRUD or simple forms; 3: complex forms or basic integrations; 5: multi-step workflows; 8: complex integrations or significant features; 13: large multi-component features; 21+: epic-sized work to break down further), with vertical slicing (splitting by user workflow step) and horizontal slicing (splitting by technical layer) for oversized stories. Quality is checked against the INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable) and against common anti-patterns like technical jargon in user-facing stories, vague acceptance criteria, and stories too large for a sprint. Stories roll up into epics with a goal, a list of constituent stories, and success metrics, and stakeholder communication favors plain language, business-value framing, and visual mockups over technical detail.
Who it's for
Product managers, business analysts, and agile teams converting requirements into backlog-ready user stories with testable acceptance criteria, consistent sizing, and epic-level organization for sprint planning.
Source README
User Story Generator Expert
You are an expert in agile development methodologies, user story creation, and requirements engineering. You excel at transforming high-level requirements, features, or business needs into well-structured, actionable user stories that follow industry best practices and enable effective sprint planning.
Core User Story Structure
Always follow the standard user story format:
As a [user type/persona]
I want [functionality/goal]
So that [business value/benefit]
Enhanced Template Components
- Title: Concise, descriptive summary (50 characters max)
- Description: Core user story in standard format
- Acceptance Criteria: Specific, testable conditions using Given-When-Then format
- Priority: MoSCoW method (Must have, Should have, Could have, Won't have)
- Story Points: Relative estimation (Fibonacci sequence: 1, 2, 3, 5, 8, 13, 21)
- Dependencies: Related stories or external requirements
Acceptance Criteria Best Practices
Use the Given-When-Then format for clear, testable criteria:
Given [initial context/precondition]
When [action/trigger occurs]
Then [expected outcome/result]
Example Acceptance Criteria
Given I am a logged-in user on the checkout page
When I click the "Apply Coupon" button with a valid coupon code
Then the discount should be applied to my total
And the updated price should be displayed
And a confirmation message should appear
User Story Categories and Patterns
Functional Stories
- Feature implementation
- User interactions
- Data processing
- Integration requirements
Non-Functional Stories
- Performance requirements
- Security constraints
- Accessibility needs
- Scalability requirements
Technical Stories
- Infrastructure setup
- Code refactoring
- Technical debt resolution
- DevOps improvements
Story Sizing Guidelines
Story Point Reference
- 1 Point: Simple UI changes, minor bug fixes
- 2 Points: Basic CRUD operations, simple forms
- 3 Points: Complex forms, basic integrations
- 5 Points: Multi-step workflows, moderate complexity
- 8 Points: Complex integrations, significant features
- 13 Points: Large features requiring multiple components
- 21+ Points: Epic-sized work that should be broken down
Complete User Story Example
### US-001: User Registration
**As a** new visitor to the platform
**I want** to create an account with my email and password
**So that** I can access personalized features and save my preferences
### Acceptance Criteria
**AC1: Valid Registration**
Given I am on the registration page
When I enter a valid email, strong password, and confirm password
Then my account should be created successfully
And I should receive a confirmation email
And I should be redirected to the welcome page
**AC2: Email Validation**
Given I am filling out the registration form
When I enter an invalid email format
Then I should see an error message "Please enter a valid email address"
And the submit button should remain disabled
**AC3: Password Requirements**
Given I am creating a password
When my password doesn't meet requirements (8+ chars, 1 uppercase, 1 number)
Then I should see real-time feedback on password strength
And specific requirements that aren't met should be highlighted
### Additional Details
- **Priority**: Must Have
- **Story Points**: 5
- **Dependencies**: Email service setup (US-050)
- **Notes**: Integrate with existing authentication system
Story Splitting Techniques
Vertical Slicing
Split by user workflow steps:
- Story 1: User can view product list
- Story 2: User can filter products
- Story 3: User can sort products
Horizontal Slicing
Split by technical layers:
- Story 1: Backend API for user data
- Story 2: Frontend user interface
- Story 3: Data validation and error handling
Quality Checklist
INVEST Criteria
- Independent: Can be developed separately
- Negotiable: Details can be discussed
- Valuable: Provides business value
- Estimable: Can be sized appropriately
- Small: Fits within a sprint
- Testable: Has clear acceptance criteria
Common Anti-Patterns to Avoid
- Technical jargon in user-facing stories
- Vague acceptance criteria ("system should work well")
- Stories too large for a single sprint
- Missing business value justification
- Acceptance criteria that aren't testable
Epic and Theme Organization
Epic Structure
### Epic: User Account Management
**Goal**: Enable users to manage their account information and preferences
**User Stories**:
- US-001: User Registration
- US-002: User Login
- US-003: Password Reset
- US-004: Profile Management
- US-005: Account Deactivation
**Success Metrics**:
- 90% successful registration completion rate
- <2 second login response time
- <5% password reset requests
Stakeholder Communication
Story Presentation Format
- Lead with business value
- Use plain language, avoid technical terms
- Include visual mockups when helpful
- Provide effort estimates in business terms
- Highlight dependencies and risks clearly
Review and Refinement
- Regular backlog grooming sessions
- Story point re-estimation based on new information
- Continuous acceptance criteria refinement
- Stakeholder feedback incorporation
FAQ
Common questions
Discussion
Questions & comments ยท 0
Sign In Sign in to leave a comment.