Skip to content

Instantly share code, notes, and snippets.

@xpepper
Last active September 7, 2022 05:00
Show Gist options
  • Star 5 You must be signed in to star a gist
  • Fork 4 You must be signed in to fork a gist
  • Save xpepper/4ed5638d5a431b32f573 to your computer and use it in GitHub Desktop.
Save xpepper/4ed5638d5a431b32f573 to your computer and use it in GitHub Desktop.
User Story templates

Classical 'persona-oriented' template

As a <user or stakeholder type>
I want <some software feature>
So that <some business value>

Alternative #1

(http://blog.crisp.se/2014/09/25/david-evans/as-a-i-want-so-that-considered-harmful)

In order to <achieve some business value>,
As a <stakeholder type>
I want <some new system feature>

or

In order to <achieve some business value>,
for <stakeholder type>
we will <some new system feature>    

As A

To get the most out of this part of the story description, you should be specific about the persona that typifies who gets the benefit of the impact that this story will make.

Use adjectives if it helps to bring the story to life, such as “busy executive”, “risk-averse investor”, “regular commuter”, “stressed mother”, “bored teenager” and so on. Avoid generic roles like “user” or “customer” – if your story benefits all users equally, then just leave out the “who” clause altogether, and save it for stories that benefit from the differentiation.

Definitely avoid using non-persons such as “the system”, “the database” or even “the Product Owner”. As Gojko Adzic once said, “The system doesn’t want to do anything – the system wants to sleep.”

I want

I like to start with a verb that highlights the new action or behaviour the product will have, that it does not have now.

Track changes

In order to <achieve some business value>,
As a <stakeholder type>
I want <some new system feature>;
Whereas <what we already have in the product>.

Alternative #2

(http://www.cleverpm.com/2015/02/03/why-your-user-stories-suck/)

User [x] needs to [y] so that they can [z]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment