User Stories

Agile User StoriesUser Stories are a simple way of capturing user requirements throughout a project – an alternative to writing lengthy requirements specifications all up-front.

User Stories are derived from XP (Extreme Programming), however they can just as easily be used for requirements gathering in any agile development methodology, or indeed in any home-grown development process.

A User Story is a simple statement about what a user wants to do with a feature of the software, written from a user’s perspective. A User Story should not use technical jargon or state design goals. User Stories should be written in business language that is understandable to all.

A User Story should focus on the who, what and why of a feature, not how.

For example, on a job site, two high-level User Stories might be:

  • As a job seeker, I want to search for a job, so I can advance my career.
  • As a recruiter, I want to post a job vacancy, so I can find a new team member.

This is a useful construct to give a consistent shape to User Stories, and to act as a constant reminder to focus on who, what and why:

As a [user role], I want to [goal], so I can [reason].

Some people may consider the third part of the construct to be unnecessary. However I think it’s good to state the user’s motivation for using the feature, because:

(a) it gives clarity as to why a feauture is useful;
(b) it can influence how a feature should function;
(c) it can give you ideas for other useful features that support the user’s goals.

At the start of a project, capture an initial list of User Stories up-front. In Scrum this would be the initial Product Backlog. This feature list is useful for estimating and planning. But defer capturing all the details until the story is prioritised and due to be developed in the next Sprint or iteration.

In meetings with users (or user representatives), users will often tell stories about the failings of their current system or process. Or they might tell stories about how they see things working better in future. Try capturing these stories as User Stories. On cards. While you’re in the meeting. As they are told.

In traditional development projects, these stories often aren’t captured as they are told, they’re captured in a lengthy analysis process and captured in a lengthy document; a format that isn’t particularly user friendly.

Using User Stories, you might be surprised just how easy it is to leave a meeting with users, with their key requirements already captured.


11 Responses to “User Stories”

  1. Oleg Puzanov says:

    I would like to use nine boxes tool for user stories building. More can be read here:
    and here in russian:

  2. Andrew Orange says:

    It can also be useful to keep pushing the “so that”s to achieve a hierarchy of aims. c.f. Coverdale. Sometimes these can completely change one’s perspective on the task in hand.

    E.g. as a user I want to receive email alerts of new jobs SO THAT I don’t have to keep back in the site for new jobs SO THAT I can save time job seeking. AND SO that I am first to know about jobs as soon as they are posted… SO THAT

    … which could lead one to other, more effective solutions – e.g. RSS

  3. AgileJoe says:

    I also like to include the detriment as you can assess value during the planning game with the customer.

    [As as][I want][So that:Benefit] [If I don’t:detriment]

  4. Nash says:

    Stories sounds like a key concept but your example doesn’t sound helpful at all for estimating.

    You said: As a job seeker, I want to search for a job, so I can advance my career.

    Now search can be as simple as simple text search.

    It could be more complicated with say with filters on experience required, skill required, location.

    It could have sorting on the results; sorting could be on any one of 10 possible job attributes.

    With such a wide variation of the simple “As a job seeker, I want to search for a job, so I can advance my career.” How can that be useful to generate an estimate?

    I think it is useful for the customer to speak as much as they like about the story. It wouldn’t hurt if they said: “As a job seeker, I want to search for a job, so I can advance my career. I should be able to search by location, by skill, by experience, by salary, by keywords. All the results must fullfill all my criteria.”

    Wouldn’t that be more useful?

  5. hssaroch says:

    Epic is the solution to the problem that you have mentioned. An epic is like a user story but on a very high level. Many user stories may fall under one epic.

  6. Nash says:

    Thank you Hssaroch! I will look into Epics for sure. I’d love to know if you have a handy link.

  7. Tarek Koudsi says:

    Been using User Stories for a while and almost always get confused, only now I know they call it “Epic”..

  8. Excellent definition of the User Story.

  9. Erman Taylan says:

    Hi Kelly,

    Really useful article. And i have a questions for you:

    Is there any approach between test cases and user stories. Like, “for one user stories, create one tc” or something? Or it depends on what user stories’ scope?



  10. Anuradha says:

    Who owns and write the user stories?

Leave a Reply

What is 7 + 3 ?
Please leave these two fields as-is:
Please do this simple sum so I know you are human:)

There are 101 ways to approach anything.
To find the best way, sometimes you need expert help

What People Say

“Kelly revolutionised the way our digital department operated. A true advocate of agile principles, he quickly improved internal communication within our teams and our internal clients by aligning our business and creating a much enhanced sense of transparency in the decisions the business was making. Kelly also introduced a higher sense of empowerment to the development teams...”


“Kelly’s a leading program director with the ability to take charge from day one and keep strong momentum at both a program and project level driving prioritisation, resourcing and budgeting agendas. Kelly operates with an easy-going style and possesses a strong facilitation skill set. From my 5 months experience working with Kelly, I would recommend Kelly to program manage large scale, complex, cross company change programs both from a business and IT perspective.”


“Kelly is an extremely talented and visionary leader. As such he manages to inspire all around him to achieve their best. He is passionate about agile and has a wealth of experience to bring to bear in this area. If you're 'lucky' he might even tell you all about his agile blog. Above all this, Kelly is great fun to work with. He is always relaxed and never gets stressed - and trust me, he had plenty of opportunity here! If you get the chance to work with Kelly, don't pass it up.”


“Kelly is an Agile heavy-weight. He came in to assess my multi-million $ Agile development program which wasn’t delivering the right throughput. He interviewed most of the team and made some key recommendations that, when implemented, showed immediate results. I couldn’t ask for more than that except he’s a really nice guy as well.”


“Kelly and I worked together on a very large project trying to secure a new Insurer client. Kelly had fantastic commercial awareness as well as his technical expertise. Without him I would never had secured this client so I owe a lot to him. He is also a really great guy!”


“Kelly came to the department and has really made a huge impact on how the department communicates, collaborates and generally gets things done. We were already developing in an agile way, but Kelly has brought us even more into alignment with agile and scrum best practices, being eager to share information and willing to work with us to change our processes rather than dictate how things must be done. He is highly knowledgable about agile development (as his active blog proves) but his blog won't show what a friendly and knowledgeable guy he is. I highly recommend Kelly to anyone looking for a CTO or a seminar on agile/scrum practices - you won't be disappointed!”


“Kelly was a great colleague to work with - highly competent, trustworthy and generally a nice bloke.”


“Kelly was engaged as a Program Director on a complex business and technology transformation program for Suncorp Commercial Insurance. Kelly drew on his key capabilities and depth of experience to bring together disparate parties in a harmonised way, ensuring the initiate and concept phases of the program were understood and well formulated. Excellent outcome in a very short time frame. ”


“I worked with Kelly on many projects at IPC and I was always impressed with his approach to all of them, always ensuring the most commercially viable route was taken. He is great at managing relationships and it was always a pleasure working with him.”


“I worked with Kelly whilst at Thoughtworks and found him to be a most inspiring individual, his common-sense approach coupled with a deep understanding of Agile and business makes him an invaluable asset to any organisation. I can't recommend Kelly enough.”


“Kelly was a brilliant CTO and a great support to me in the time we worked together. I owe Kelly a great deal in terms of direction and how to get things done under sometimes difficult circumstances. Thanks Kelly.”