The Art of Writing Agile User Stories

No matter how well-architectured the app you built is, if it brings no value to users, chances are, no one will use it. In simple terms, are brief, informal descriptions of a software feature told from the perspective of the users. These answer the and of a single task/functionality in an application. user stories "who," "what," "why" User Story Format As a(n) , I want to so I can Example As a , I want to , so I can . customer view the list of menu items easily choose what food to order The answers the "who," the refers to the "what," and finally, the explains the "why" in a user story. user type function benefit What Makes a Great User Story? Now that you know the typical format for a user story, the next question that comes to mind is . "What makes a great user story?" Your backlog should not be filled with stories that actually do not provide user value. If you do, you could waste a lot of time and effort planning for and working on tasks that don’t add much, if any, business value to your project. Image by from Andre Simones one80agiletraining INVEST Fortunately, coined the term "INVEST" which serves as a reminder of what characteristics of a high-quality user story. INVEST stands for: Bill Wake : User stories should not be dependent on one another. Independent : Should leave space for discussion. Negotiable : Must deliver value to the stakeholders. Valuable : You should be able to estimate the size and scope of a user story. Estimable : The user story should be small enough to easily plan and prioritize it. Small : You should be able to test the results of development. Testable Ideally, your user stories should have all of these characteristics, because they enable you to easily determine how each task fits into your project timeline. By following INVEST, it is much easier to decide which items you must fulfill first, and which ones can wait until later. Examples of Bad User Stories Image by from Roman Pichler romanpichler Here are examples of bad user stories, and why they don't work: As a customer ordering fast food online, I want to find previous food order lists so that I can see all the orders that I have. The benefit/value is absent from this user story, because is just a re-statement of . Problem: so that I can see all the orders that I have find previous food order lists As a QA tester, I want to have access to test plans so that when the product is finished, I know how to test it. Users do not really care about test plans, they just want quality products. Problem: As a Jam’s dining customer, I want various food item categories displayed in different colors: red for meats, magenta for grains, and olive green for vegetables and fruits—so that I can easily group my food items by food type. The user story is way too technically specific and robotic. This not only fails to represent a user but also limits the creativity of the developers. Problem: Examples of Great User Stories Image from justinmind.com In contrast to the previous bad examples, here are the user stories that work well: As a customer ordering fast food online, I want to find my saved food order lists so that I can reuse them for future orders, allowing me to order faster and more accurately. As a Jam’s dining customer, I want items to have a custom item code so that I can quickly find an item on a screen. As a logged in user, I would like a login timeout and log off after a certain amount of time so that I can have some protection against unauthorized use when my computer is left unattended These user stories work well because they have the characteristics of INVEST: Their functionality is not dependent on other stories. They leave room for different implementation options. They add user value to the project. Their scope and size can definitely be estimated by developers. They are small enough to be planned around and/or reprioritized against other stories. They can be tested. Completing a User Story Now that you know how to make great user stories, you'd probably like to know when they are finished. A user story is completed when it meets its and its (DoD). But what do these terms mean? Acceptance Criteria Definition of Done Image from agilemania Acceptance Criteria The Acceptance Criteria of a user story consist of to ensure that the software is working as intended. Like user stories, acceptance criteria should be written from the perspective of a user. the set of test cases that must be fulfilled They should be clear, concise, and easily utilized by the development team. Acceptance criteria should not be concerned about implementation, but only about which features should be present and included. Each user story will have different Acceptance Criteria based on its requirements. Definition of Done (DoD) The Definition of Done (DoD) is a for the team to call it complete. list of requirements that a user story or Increment must adhere to The DoD serves as a checklist that guides various pre-implementation activities such as discussion, estimation, and design. By ensuring that the DoD is followed, the team can minimize reworking on user stories. Its difference from Acceptance Criteria is that whereas . DoD is common for all the user stories Acceptance Criteria are applicable to only a specific user story User Stories in Agile/Scrum Environments Image by from Notion Nate Martins In Agile/Scrum environments, a team would utilize user stories as part of their Product Backlog. Each story represents a single unit of functionality in a project, and a backlog contains multiple user stories. Many teams nowadays use issue trackers or tickets for listing user stories, while others still use sticky notes. As PBIs become higher-ordered in the Product Backlog, they tend to be broken down into user stories with more specific tasks listed. Unlike a Product Backlog Item (PBI), a user story depicts more than just a specific requirement, change, or bug fix. Its focus is on the end-user and their experience. A user story is an increment that provides value to the overall product. 3Cs of User Stories An Agile user story has three primary components, each beginning with the letter "C" hence the "3Cs": Card Conversation Confirmation Card The "Card" refers to the of the user story and serves as an invitation to conversation. written text Typically, user stories would be written on index cards, hence the "Card" aspect. One benefit of this is to keep a user story concise but still provide enough information. It also allows a team to discover more about the user's needs through conversation. The most common format of the user story "Card" is: As a(n) , I want to so I can User stories do not necessarily have to follow this format, but it helps keep those three important things to mind. Conversation The "Conversation" is a , usually in-person, facilitated by the Product Owner. This interaction involves all stakeholders and the team. It encourages continuous, incremental collaboration among the Agile team members by allowing them to have a shared understanding of a problem. collaborative interaction The team will make adjustments to the "Card" based on the information gained from having the "Conversation." While these conversations are typically verbal, automated tests and documentation support them. Confirmation Finally, the "Confirmation" in a user story determines whether it's completed or not. It refers to the . Acceptance Criteria which declare the story's requirements The user story is only finished once the acceptance tests pass and the Acceptance Criteria are met. Typically, the Product Owner will have to verify the completion of the user story before it is considered "done." Pros and Cons of User Stories Image from heavencpa Advantages of User Stories: Helps ensure that a functionality brings user value. Follows Agile/Scrum core principles. Makes it easier to organize software functionality, as it leaves out implementation details. Allows team members of different expertise and backgrounds to plan an application more easily. Encourages conversations rather than simply handing out document details. Simple to prioritize and reorder, especially for product backlog items. Easily understood by both clients and developers. Disadvantages of User Stories: Does not explain the "how?" Does not involve non-functional requirements (e.g. fault tolerance, performance, usability, modifiability) User stories are not substitutes to business requirements. The lack of implementation details means that the processes could vary a lot from team to team. Can be misunderstood and misused. Can lose its original essence/purpose (especially in companies and teams that are "Agile" only for compliance purposes). Frequently Asked Questions (FAQ) Who writes user stories? In an Agile/Scrum environment, the Product Owner is responsible for the backlog of all user stories. Anyone can write user stories. However, anyone in the entire team can make them. Solo developers can also utilize user stories to help guide them when building a project. When should you write user stories? Typically, a team will hold a meeting at the start of the project to create user stories to identify initial project requirements. User stories can be written anytime. It is impossible to identify all of them at the beginning, so the team will create user stories over the course of the project timeline as they discover more user requirements. When is a user story completed or finished? A user story is completed when it meets its Acceptance Criteria and its Definition of Done (DoD). Do user stories replace a requirements document? A user story focuses on the experience and needs of users, while a requirements document goes into a lot of detail about features necessary for a project. They don't, as they serve different purposes. User stories focus on the , , and . On the other hand, requirements documents contain the and . who what why what how What are the differences between user stories and Product Backlog Items? At first glance, they seem similar, but there is a key difference: User stories place an emphasis on the end-users and their experiences. On the other hand, a Product Backlog Item merely represents a specific change, requirement, or bug fix without being concerned much about the . who Are user stories like pseudocode? They are used differently. Pseudocode is mainly concerned about implementation details and how a developer would build a solution, and user stories completely leave out the implementation details in exchange for focusing on the user experience. User stories are mainly concerned about the , , and . On the other hand, pseudocode describe the and . who what why what how Concluding Remarks Writing user stories is not difficult, but it's also easy to get them wrong. You should be fine as long as the user stories you write fulfill the following: Written from the perspective of a user. Identify the user, the feature, and the benefit (or answer the ). "who, what, and why?" Have the characteristics of INVEST. Not too restrictive in terms of implementation. Have Acceptance Criteria and Definition of Done (DoD). However, user stories do not cover implementation details and are not substitutes for a requirements document. User stories are great for identifying user needs and increasing the business value of a product. A user story is the smallest, functional unit in the Agile/Scrum Product Backlog. Most modern software development teams will require you to use it, so it is definitely worth learning. And even as a solo developer, writing down user stories will help you build a project that has user value and prioritize which features you should implement first. Try writing user stories before you build your next project, and see how it helps! Resources/Recommended Reading: User Story Guide by Mike Cohn How To Create a Perfect User Story - Step by Step Guide New to Agile? INVEST in good user stories Definition of Done vs Acceptance Criteria Effective User Stories DISCLAIMER: ***This is a Starter Guide meant for introducing beginners to user stories. *** This guide only expresses my thoughts and opinions (based on my limited knowledge) and is in no way a substitute for actual references. If I ever make a mistake or if you disagree, I would appreciate corrections and discussions in the comments! First published here.