Martin Fowler: User Stories

user stories are chunks of desired behavior of a software system. they are widely used in agile software approaches to divide up a large amount of functionality into smaller pieces for planning purposes. you also hear the same concept referred to as a feature , but the term "story" or "user story" has become prevalent in agile circles these days.

kent beck first introduced the term as part of extreme programming to encourage a more informal and conversational style of requirements elicitation than long written specifications. the essence of a story can be written on a single note card (kent and i prefer 3" by 5"). stories are deliberately not fleshed out in detail until they are ready to be developed, you only need enough understanding to allow prioritization with other stories.

bill wake came up with the invest mnemonic to describe the characteristics of good stories:

• independent : the stories can be delivered in any order
• negotiable : the details of what's in the story are co-created by the programmers and customer during development.
• valuable : the functionality is seen as valuable by the customers or users of the software.
• estimable : the programmers can come up with a reasonable estimate for building the story
• small : stories should be built in a small amount of time, usually a matter of person-days. certainly you should be able to build several stories within one iteration.
• testable : you should be able to write tests to verify the software for this story works correctly.

a common way to formulate stories is the "as a … i want … so that …" form. the "as a" clause refers to who wants the story, "i want" describes what the functionality is, "so that" describes why they want this functionality. the "so that" part provides important context to understand to help get from what the customer think they want to providing what they actually need.

mike cohn wrote what is now the standard book on writing user stories . to understand the roots of user stories in xp consider the white book , or the tasteful green book . in an earlier bliki entry i discuss why usecasesandstories are different.