User Stories That Developers Can Actually Work With

by Rivi Aspler

Devout Agile evangelists will define a user story as a short, simple description of a feature told from the perspective of the person who desires the new capability. The user story will typically follow a simple template: As a <type of user>, I want <some goal> so that <some reason>.

And furthermore, while a product backlog can be thought of as a replacement for the requirements document of a traditional project, it is important to remember that the written part of a user story (“As a user, I want…”) is incomplete until the discussions about that story occur and the discussions are those that actually enrich the user stories with enough details that R&D teams can chew on.

So much for theory and now for practice….

I have found that the concise user stories are simply not enough. It is especially apparent when one or more of the following occurs:

  • A – You are defining a new product, that doesn’t have enough legacy definitions, neither an established UI paradigm that the PO or the Agile team can rely on.
  • B – You are defining an utterly complicated product that requires an intensive analysis of hundreds of user stories, using multiple points of view (personas).
  • C – Your organizational culture is such that it encourages written down detailed specifications.
  • Since all of the above is my day-to-day reality, at my company, we are using the following guidelines for a user story template.

    Looking at the user story below, one can easily notice the following:
    1. We are using a table format.
    2. The left column of the table is dedicated to the ‘meta-data’ of the various definitions.
    3. Each user story has the same ‘meta-data’ topics listed down so that the PO and the developers can easily understand each-other.
    4. The user story defines a very granular scenario.
    5. The other user stories that complete the ‘Place an Order’ Theme are detailed in other user stories (i.e. the references to US19, US38 and US39)
    6. A UI design is attached since one picture is always better than a thousand words…
    Number
    US37
    ThemePlacing an Order
    Role
    • Registered Shopper (Has an existing account, possibly with billing and shipping information)
    • Non-registered Shopper (Does not have an existing account)
    PriorityCritical
    User NeedAs a user, I want to confirm billing and shipping information
    Starting PointUser has selected the items to be purchased
    User Flow

    1. The user will indicate that she wants to order the items that have already been selected.
    2. The system will present the billing and shipping information that the user previously stored.
    3. The user will confirm that the existing billing and shipping information should be used for this order.
    UI Design
    DoD

    • The system will confirm shipping and billing addresses
    • The system will present the amount that the order will cost, including applicable taxes and shipping charges.
    Default Values For a registered shopper, the billing and shipping addresses are the ones that were defined as default addresses (US 19)
    Alternative Flow 1US 38 – The user will discover an error in the billing or shipping information associated with their account, and will edit it.
    Alternative Flow 2US 39 – The user isn’t a registered shopper and doesn’t have pre-defined shipping and billing addresses

    To conclude, the above detailed template may not stick to pure Agile recommendations, but it does represent a win-win best practices for the type of definitions that developers practically need in order to get your story coded.

    Rivi

    Tweet this: User Stories that Developer can Actually Work With http://wp.me/pXBON-3ls #prodmgmt #agile

    If you enjoyed this post, please consider leaving a comment or subscribing to the RSS feed to have future articles delivered to your feed reader.

    Related posts:

    1. Stories about users and User Stories
    2. User stories should be implementation free
    3. My Agile Product Backlog Template
    4. 4 Product Management Success Stories
    5. Socks in awe: Customer interviews vs. User observation
    47 Responses to User Stories That Developers Can Actually Work With
    1. Nicolai says:

      This is almost exactly the way, we’re defining user stories, very useful! However, I didnt get how the “agile training board” is connected to the article. Is it explained in another post?

      • Rivi Aspler says:

        Thanks Nicolai!

        The Agile training board image was attached since when I started working with Agile, the Agile-trainers said that the board is just enough to get everyone on the same page.

        Luckily, we soon realized that the card board should be treated as a reference board to the detailed user stories.

        Rivi

    2. User Stories That Developers Can Actually Work With: 0savesSave by Rivi… http://t.co/fRYEPpiE #AgileDevelopment #ProductManagement #Agile

    3. Paul Raphael says:

      User Stories that Developer can Actually Work With http://t.co/fktLUm7H #prodmgmt #agile

    4. Melissa Hui says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    5. User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    6. Reading: User Stories That Developers Can Actually Work With http://t.co/jC4CouHT #baot #iiba

    7. Pete says:

      What you have essentially created is a Use Case, but if it works for you then that’s all that matters. Its nice to see non-traditional examples of Agile to see how people adapt a methodology to fit their company culture and needs.

      Most people I’ve run into use a blended approach of agile methodologies anyway so examples like these are very helpful.

      • raspler says:

        The example does demonstrate a blend between a user case and a user story. Is it close to aether one? I guess its in the eyes of the beholder…

        It is interesting to read in your comment the fact that most people create some sort of a blended template. In my opinion that goes a long way to show that pure out-of-the-box Agile is ignoring real-life challenges.

        Rivi

    8. Dave McClure says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    9. Jonathan Van says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    10. User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    11. Jon Troth says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    12. Michael Eder says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    13. User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    14. Sean Macleod says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    15. Morgan Brown says:

      User Stories that Developer can Actually Work With http://t.co/ZNNmYkoW #prodmgmt #agile

    16. Dermot Lally says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    17. Peter Guba says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    18. Eoin Brazil says:

      User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    19. Elad Amit says:

      “@MelissaHui: User Stories That Developers Can Actually Work With: http://t.co/5MepUvZe” umm… Use cases?

    20. User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    21. Tony Perea says:

      RT @onpm: User Stories That Developers Can Actually Work With http://t.co/5DX3JM9G

    22. User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    23. Rivi Aspler says:

      User Stories that Developer can Actually Work With http://t.co/BM9ZufxY #prodmgmt #agile

    24. RT @onpm: User Stories That Developers Can Actually Work With http://t.co/zRqs6ebV #prodmgmt #agile #userstory

    25. Alyssa Fox says:

      User Stories That Developers Can Actually Work With http://t.co/EXSWAhUg

    26. User Stories That Developers Can Actually Work With http://t.co/EXSWAhUg

    27. Mr DC says:

      Blending User Stories with Use Cases to get the best of both worlds http://t.co/hooFOpYw

    28. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    29. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    30. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    31. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    32. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    33. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    34. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    35. Glen Ford says:

      I like this post–but the #prodmgmt #fail is in the comments full of repeated tweets. Cheap=awful here. http://t.co/Zt4xJuJ1

    36. Glen Ford says:

      User Stories That Developers Can Actually Work With | http://t.co/Zt4xJuJ1 #prodmgmt #agile

    37. User Stories that Developer can Actually Work With http://t.co/D0CHpgyN #prodmgmt #agile #techcomm

    38. Currently Reading: User Stories That Developers Can Actually Work With http://t.co/7u3dCBRe

    39. User Stories That Developers Can Actually Work With: http://t.co/gSiHjwSb

    40. Vin D'Amico says:

      RT @afox98: User Stories That Developers Can Actually Work With http://t.co/kJ4GwJOG / a "use story"?

    41. SiteFox says:

      User Stories That Developers Can Actually Work With http://t.co/h76gz7Xb

    42. Adam Gross says:

      User Stories that Developer can Actually Work With http://t.co/jhwB2b6s #prodmgmt #agile

    43. User Stories that Developer can Actually Work With http://t.co/jhwB2b6s #prodmgmt #agile

    44. Bradley says:

      User Stories that Developer can Actually Work With http://t.co/cHvewrBk #prodmgmt #agile

    45. User Stories that Developer can Actually Work With http://t.co/cHvewrBk #prodmgmt #agile

    Leave a Reply

    Your email address will not be published. Required fields are marked *

    *

    You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>