Skip to content

Instantly share code, notes, and snippets.

@Dashon-Hawkins
Forked from xpepper/user story template.md
Created September 19, 2020 09:37
Show Gist options
  • Save Dashon-Hawkins/8c5bac13dc661463f6941bdae9ccca8d to your computer and use it in GitHub Desktop.
Save Dashon-Hawkins/8c5bac13dc661463f6941bdae9ccca8d 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