What makes a “good” story

04 September

This morning I received an email that asked how a team will know their stories are good enough?

This question is one that frequently comes up in classes, and the right answer (of course) is “it depends”, which probably doesn’t help you much.

So – what does it depend on?  Here are my thoughts . . .

The most common structure for a user story is

  • As a <role> I want <feature> so that <benefit can be achieved>

It’s important to carefully evaluate each component of the story -

  • Role - Who needs this feature from the system,
  • Feature – A succinct statement of the need
  • Benefit – The business benefit that this feature will deliver, this must be traceable to the project goals and objectives

It is important to remember that a user story is not intended to be the detailed requirement – it is a “placeholder for a conversation”.  A story has three C’s associated with it

  • Card – the statement of the business need
  • Conversation – the elaboration discussion that happens shortly before the story is ready to be implemented, this conversation will flesh out the detail and allow the team to build the third part the
  • Confirmation – the elaborated details that form the basis of the test cases and confirm that the story has been delivered

The “Card” is the one-line statement of the feature to be delivered, often in the “As a … I want … so that” format.

The “Conversation” component of the story is how the detailed requirements get identified – the conversation happens shortly before the team is ready to build that piece of the product.

The “Confirmation” component makes up the acceptance criteria that will show if the story has been implemented correctly.  The test design criteria that are agreed to when the conversation happens.  Defining the confirmation criteria is how the detailed requirements are expressed – this could include screen mockups, technical design details, quality guidelines (performance, security, usability …) and any other details that will help the team build and test the feature into the product.  The minimum confirmation criteria that should be included are a set of test designs, often expressed in the Behavior Driven Design format of “given … when … then”.  I’ll examine this in more detail in a later entry…

A good story is one that identifies the piece of functionality or quality to be delivered at a level that the business representatives on the team can prioritise and the technical team members can estimate.  It should be small enough to be understandable and convey the business benefit without needing detailed explanation.

How small is small – a rough guideline is four days or less of team effort to deliver the story on its own.  Not taking into account any “plumbing” or architectural work that needs to be done to enable the functionality.   Team effort means all the work that needs to be undertaken to deliver the story to the “done” state – whatever analysis, design, development, unit & system testing and user acceptance testing is needed.

Here are a few example stories, and some ideas about them

As a book reader I want to buy my ebooks online so I can read them whenever I want

Large stories such as this are often referred to as Epics – an epic explains a large business goal, but is way too large to estimate effectively, and very difficult to prioritise.  Epics are OK in a story list, as long as they are not high priority items – an epic that is high priority should be broken down into usable stories before so they can be estimated and prioritised.  Low priority epics remain in the story list until shortly before the team is ready to work on them, then they need to be expanded into usable stories.

As a book owner I want to see a list of the books in my online library sorted in alphabetical order by author or title or date purchased and be able to dowload them in a zip file so I can read them on my iPad

This story is complex and imposes unnecessary constraints on the way books are sorted and downloaded.

As a book purchaser I want to store my reading preferences so I can receive recommendations about books I might enjoy

As the company accountant I want purchasers to pay for books using PayPal so that we don’t need to set up credit card facilities

As a book owner I want to select the download file format so that I can read my books on multiple devices

These stories are about the right size and structure.

What advice can you offer to teams working with stories?

Needless to say, these concepts are not original thought – Mike Cohn, Ron Jeffries, Kent Beck and many others have written extensively on these topics, and I’ve been fortunate to be influenced and informed by their work.   A fantastic book that describes many of these concepts is Mike Cohn’s  “User Stories Explained – For Agile Development”.


Posted by Shane Hastie