User stories are probably the most popular technique to capture product functionality in an agile context. A story contains a name, a brief narrative, and acceptance criteria. It’s comparatively easy to write, decompose, and refine user stories. But writing good stories can be hard. The following ten tips help you tell powerful stories.
- Focus on the user: As its name suggests, a user story should tell a story about a customer or user employing the product. Write stories from the user’s perspective and employ user roles, such as corporate user, consumer, admin, marketer. The popular story format “As a (user role), I want (function) so that (benefit)” helps you get the focus right.
- Use stories to facilitate a conversation with the team and with the users, the customers and the other stakeholders. A story is not a specification, and it does not replace a dialogue. The opposite is true: Stories capture the essence of a conversation about how users interact with the product.
- Story writing is teamwork: Leverage the creativity and knowledge of the team and the stakeholders to discover great stories. Invite the team to detail the stories to get them ready for the next sprint planning meeting.
- Keep your stories simple and concise: Use language that is easy to understand. Avoid confusing and ambiguous terms and use active voice. Focus on what’s important, and leave out non-essential information.
- Progressively decompose your stories: Start with big, goal-oriented stories (epics), and derive small, detailed stories that are ready to be transformed into a product increment.
- Don’t forget the acceptance criteria: As you decompose epics into smaller stories, remember to add acceptance criteria. Acceptance criteria complement the story’s narrative, state when the story is complete, and ensure that it is testable.
- Consider grouping user stories into themes: Use themes to organise your stories. Each theme is a group of related stories. Sample themes for a mobile phone are email, calendar, voice communication, and organizer, for instance. Themes make it easier to check for completeness and consistency, they structure your product canvas or product backlog, and they facilitate prioritisation.
- Use paper cards: Paper cards are not only cheap and easy to use. They also facilitate collaboration; everyone can grab a card and write down an idea. They can also be easily grouped on the table or wall to check for consistency and completeness.
- Keep your stories visible: Stories want to communication information. Don’t hide them on a network drive or in the corporate intranet jungle. Put them up on the wall so that everyone can see them.
- Some things aren’t stories: Don’t feel obligated to describe every single aspect of the product as a user story. For instance, user interface design ideas are often best captured in form of paper sketches.
The following posts provide more information on user stories:
Epics and Ready Stories to write stories at the right level of detail.
Constraint stories to capture non-functional requirements such as performance.
Personas to discover the right stories.
User Story Modelling to describe the relationship between different stories.
Agile Scenarios and Storyboards to discover and explore user stories.
Product Canvas to manage and visualise stories.
You can learn more about working with user stories by attending my Certified Scrum Product Owner training course.
thanks for the post
Thanks a lot for this. We featured this on our article today
[...] Roman Pichler: Writing good user stories [...]
[...] user stories to capture functional requirements. Start with large, coarse-grained stories and progressively [...]
[...] Roman Pichler: Writing Good User Stories [...]
[...] I employ user stories, constraint cards, design sketches, and workflow diagrams [...]
[...] User stories to capture how target users and customer may interact with the product. [...]
[...] the individual usually has to learn new skills including [...] writing user stories. [...]
[...] should be in a better place to capture the Product Owners requirements, and ensure stories can be tests, and thus marked “done”. Share this:PrintEmailFacebookTwitterLinkedInLike this:LikeBe [...]
[...] that their feedback is incorporated in stories and sprint planning. Your user stories are focused on the user and easily understood by end users, making it easy for them to provide feedback and decide on [...]
Should the technical parts at the start of the project like setting up the environments, continuous integration, etc. be included as stories and also be estimated?
Hi Prashant, Great question. I don’t capture work results that are necessary to create a successful product but are not meaningful to a customer or user as user stories. I simply add a card that says, for instance, “Install and configure CruiseControl so that software can be continuously integrated and tested”. The example is written similar to an epic. It uses a goal/benefit clause but has no user role or persona. I would suggest, however, to estimate the item, as the team will have to spend time and effort to get it done.
Does this help?
Thank you for very fast response! It is very helpful.
Just one query though; when you say estimate the item – do you mean the relative estimation (Poker / T-shirt) ot the time estimation as done for the tasks / sub-tasks for the user stories?
Thanks once again!
Hi Prashant, I was referring to the former. I typically estimate user stories in a product backlog/canvas workshop: http://www.romanpichler.com/blog/product-backlog/the-product-backlog-grooming-steps/ The task break-down happens in the sprint planning meeting.
Thank you Roman! Very helpful thoughts…
[...] Items can be described as user stories or as use cases [...]
[...] 10 Tips for Writing Good User Stories. ‹ Top 10 Information Architecture (IA) Mistakes – Jakob Nielson Posted in [...]
[...] Writing good user stories Share this:TwitterFacebookLike this:Like Loading… [...]
[...] 10 Tips For Writing Good Uset Stories Written by: Roman Pichler [...]
[...] I like to think of an epic is as a scenario rolled up into a brief narrative [...]
[...] check out my “10 Tips for Writing Good User Stories“ [...]
[...] < Cours Cegep < benou101 10 Tips for Writing Good User Stories The role of design still puzzles many Scrum and Kanban teams I work with. When should the design [...]