Mike Cohn
Norwegian Developer’s Conference
6 June 2012
User Stories
1
© Copyright Mountain Goat Software
®
What problem do stories address?
Software requirements is a communication
problem
Those who want
the software must
communicate with
those who will
build it
2
© Copyright Mountain Goat Software
®
Balance is critical
If either side dominates, the business loses
If the business side dominates…
…functionality and dates are mandated with little
regard for reality or whether the developers
understand the requirements
If the developers dominate…
…technical jargon replaces the language
of the business and developers lose the opportunity to
learn from listening
3
© Copyright Mountain Goat Software
®
Resource allocation
We need a way of
working together so
that resource allocation
becomes a shared
problem
Project fails when the
problem of resource
allocation falls too far to
one side
4
© Copyright Mountain Goat Software
®
Responsibility for resource allocation
If developers are responsible…
May trade quality for additional
features
May only partially implement a
feature
May solely make decisions that
should involve the business
If the business is responsible…
Lengthy upfront requirements
negotiation and signoff
Features are progressively
dropped as the deadline nears
5
© Copyright Mountain Goat Software
®
Imperfect schedules
We cannot perfectly predict a software
schedule
As users see the software, they come up with
new ideas
Too many intangibles
Developers have a notoriously hard time
estimating
If we can’t perfectly predict a schedule, we
can’t perfectly say what will be delivered
6
© Copyright Mountain Goat Software
®
This is where
user stories
come in
So what do we do?
…but do it often
We make decisions based
on the information we
have
…we spread decision-
making across the project
Rather than making one
all-encompassing set of
decisions
7
© Copyright Mountain Goat Software
®
Agenda
What stories are
Writing user stories
Why user stories
8
© Copyright Mountain Goat Software
®
Three Cs
Stories are traditionally
written on note cards.
Cards may be annotated with
estimates, notes, etc.
Card Details behind the story come
out during conversations with
product owner
Conversation
story was coded correctly
Confirmation
Source: XP Magazine 8/30/01, Ron Jeffries.
9
© Copyright Mountain Goat Software
®
As a user, I want to
reserve a hotel room.
As a user, I want to
cancel a reservation.
As a vacation traveler,
I want to see photos of
the hotels.
As a frequent flyer, I
want to rebook a past trip
so that I save time
booking trips I take often.
Samples from a travel website
10
© Copyright Mountain Goat Software
®
Where are the details?
As a user, I can cancel a reservation.
Does the user get a full or partial refund?
Is the refund to her credit card or is it site credit?
How far ahead must the reservation be cancelled?
Is that the same for all hotels?
For all site visitors? Can frequent travelers cancel later?
Is a confirmation provided to the user?
How?
11
© Copyright Mountain Goat Software
®
Details as conditions of satisfaction
As a user, I can
cancel a reservation.
Verify that a premium member can
cancel the same day without a fee.
Verify that a non-premium member is
charged 10% for a same-day cancellation.
Verify that an email confirmation is sent.
Verify that the hotel is notified of any
cancellation.
• The product owner’s
conditions of satisfaction
can be added to a story
• These are essentially
tests
12
© Copyright Mountain Goat Software
®
Details added in smaller sub-stories
As a user, I can
cancel a reservation.
As a site visitor, I am
emailed a confirmation of
any cancelled
reservation.
As a non-premium
member, I can cancel up
to 24 hours in advance.
As a premium site
member, I can cancel a
reservation up to the
last minute.
13
© Copyright Mountain Goat Software
®
Techniques can be combined
These approaches are not mutually
exclusive
Write stories at an appropriate level
By the time it’s implemented, each story
will have conditions of satisfaction
associated with it
14
© Copyright Mountain Goat Software®
The product backlog iceberg
Priority
15
© Copyright Mountain Goat Software
®
Some additional useful terms
Epic
A large user
story
Theme
A collection of
related user
stories
16
© Copyright Mountain Goat Software
®
An example
As a VP Marketing, I want to
select the timeframe to use
when reviewing the
performance of past
promotional campaigns, so
that …
As a VP Marketing, I can
select which type of
campaigns (direct mail, TV,
email, radio, etc.) to include
when reviewing the
performance of past …
As a VP Marketing, I want
to review the performance
of historical promotional
campaigns so that I can
identify and repeat
profitable ones.
Clearly an epic
Epics???
17
© Copyright Mountain Goat Software
®
As a VP Marketing, I want
to see information on
direct mailings when
reviewing historical
campaigns.
As a VP Marketing, I want
to see information on TV
ads when reviewing
historical campaigns.
As a VP Marketing, I want
to see information on
email ads when reviewing
historical campaigns.
18
© Copyright Mountain Goat Software
®
Agenda
What stories are
Writing user stories
Why user stories
19
© Copyright Mountain Goat Software
®
Logging in
•See how many user stories you can
write about logging in.
•Examples:
•As a registered user, I am required to
log in so that I can access the system.
•As a forgetful user, I can request a
password reminder so that I can log in
if I forget mine.
“As a <user role>,
I <want/need/can/
etc> <goal>
so that <reason>.”
20
© Copyright Mountain Goat Software
®
Story-writing workshops
Includes whole team plus possibly some
external stakeholders
Typically not done every sprint
Brainstorm to generate stories
Goal is to write as many stories as possible
Some will be “implementation ready”
Others will be epics
No prioritization at this point
21
© Copyright Mountain Goat Software
®
Start with epics and iterate
As a frequent
flyer, I want to
book a trip using
miles.
As a frequent
flyer, I want to
rebook a trip I
take often.
As a frequent
flyer, I want to
request an
upgrade.
As a frequent
flyer, I want to
see if my
upgrade cleared.
As a frequent
flyer, I want to
see check my
account.
As a frequent
flyer, I want to
book a trip.
As a frequent
flyer, I want
to…
Frequent Flyer
22
© Copyright Mountain Goat Software
®
Agenda
What stories are
Writing user stories
Why user stories
23
© Copyright Mountain Goat Software
®
So why user stories?
If requirements are
written down
The user will get
what she wants
then
At best she’ll get
what was written“You built what I
asked for, but it’s
not what I need.”
Shift focus from writing to talking
24
© Copyright Mountain Goat Software
®
Words are imprecise
Entrée comes
with
soup or salad
and bread. • (Soup or Salad) and Bread
• (Soup) or (Salad and Bread)
Which is right?
25
© Copyright Mountain Goat Software
®
Examples
The user can enter a
name. It can be 127
characters.
The system should
prominently display a warning
message whenever the user
enters invalid data.
• Must the user enter a
name?
• Can it be other than
127 chars?
• What does should
mean?
• What does prominently
display mean?
• Is invalid data defined
elsewhere?
26
© Copyright Mountain Goat Software
®
Additional reasons
Stories are understandable
Developers and customers understand them
People are better able to remember events if
they are organized into stories†
Support and encourage iterative
development
Can easily start with epics and disaggregate
closer to development time
†Bower, Black, and Turner. 1979.
Scripts in Memory for Text.
27
© Copyright Mountain Goat Software
®
Yet more reasons
Stories are the right size for planning
Stories support opportunistic development
We design solutions by moving
opportunistically between top-down and
bottom-up approaches†
Stories support participatory design
†Guindon. 1990. Designing the Design Process.
28
© Copyright Mountain Goat Software
®
What if we had stories instead?
29
© Copyright Mountain Goat Software
®
Most importantly…
The story text we write on
cards is less important
than the conversations we
have.
Don’t forget the purpose
30
© Copyright Mountain Goat Software
®
mike@mountaingoatsoftware.com
www.mountaingoatsoftware.com
twitter: mikewcohn
(720) 890-6110
Mike Cohn
31

Introduction to User Stories

  • 1.
    Mike Cohn Norwegian Developer’sConference 6 June 2012 User Stories 1
  • 2.
    © Copyright MountainGoat Software ® What problem do stories address? Software requirements is a communication problem Those who want the software must communicate with those who will build it 2
  • 3.
    © Copyright MountainGoat Software ® Balance is critical If either side dominates, the business loses If the business side dominates… …functionality and dates are mandated with little regard for reality or whether the developers understand the requirements If the developers dominate… …technical jargon replaces the language of the business and developers lose the opportunity to learn from listening 3
  • 4.
    © Copyright MountainGoat Software ® Resource allocation We need a way of working together so that resource allocation becomes a shared problem Project fails when the problem of resource allocation falls too far to one side 4
  • 5.
    © Copyright MountainGoat Software ® Responsibility for resource allocation If developers are responsible… May trade quality for additional features May only partially implement a feature May solely make decisions that should involve the business If the business is responsible… Lengthy upfront requirements negotiation and signoff Features are progressively dropped as the deadline nears 5
  • 6.
    © Copyright MountainGoat Software ® Imperfect schedules We cannot perfectly predict a software schedule As users see the software, they come up with new ideas Too many intangibles Developers have a notoriously hard time estimating If we can’t perfectly predict a schedule, we can’t perfectly say what will be delivered 6
  • 7.
    © Copyright MountainGoat Software ® This is where user stories come in So what do we do? …but do it often We make decisions based on the information we have …we spread decision- making across the project Rather than making one all-encompassing set of decisions 7
  • 8.
    © Copyright MountainGoat Software ® Agenda What stories are Writing user stories Why user stories 8
  • 9.
    © Copyright MountainGoat Software ® Three Cs Stories are traditionally written on note cards. Cards may be annotated with estimates, notes, etc. Card Details behind the story come out during conversations with product owner Conversation story was coded correctly Confirmation Source: XP Magazine 8/30/01, Ron Jeffries. 9
  • 10.
    © Copyright MountainGoat Software ® As a user, I want to reserve a hotel room. As a user, I want to cancel a reservation. As a vacation traveler, I want to see photos of the hotels. As a frequent flyer, I want to rebook a past trip so that I save time booking trips I take often. Samples from a travel website 10
  • 11.
    © Copyright MountainGoat Software ® Where are the details? As a user, I can cancel a reservation. Does the user get a full or partial refund? Is the refund to her credit card or is it site credit? How far ahead must the reservation be cancelled? Is that the same for all hotels? For all site visitors? Can frequent travelers cancel later? Is a confirmation provided to the user? How? 11
  • 12.
    © Copyright MountainGoat Software ® Details as conditions of satisfaction As a user, I can cancel a reservation. Verify that a premium member can cancel the same day without a fee. Verify that a non-premium member is charged 10% for a same-day cancellation. Verify that an email confirmation is sent. Verify that the hotel is notified of any cancellation. • The product owner’s conditions of satisfaction can be added to a story • These are essentially tests 12
  • 13.
    © Copyright MountainGoat Software ® Details added in smaller sub-stories As a user, I can cancel a reservation. As a site visitor, I am emailed a confirmation of any cancelled reservation. As a non-premium member, I can cancel up to 24 hours in advance. As a premium site member, I can cancel a reservation up to the last minute. 13
  • 14.
    © Copyright MountainGoat Software ® Techniques can be combined These approaches are not mutually exclusive Write stories at an appropriate level By the time it’s implemented, each story will have conditions of satisfaction associated with it 14
  • 15.
    © Copyright MountainGoat Software® The product backlog iceberg Priority 15
  • 16.
    © Copyright MountainGoat Software ® Some additional useful terms Epic A large user story Theme A collection of related user stories 16
  • 17.
    © Copyright MountainGoat Software ® An example As a VP Marketing, I want to select the timeframe to use when reviewing the performance of past promotional campaigns, so that … As a VP Marketing, I can select which type of campaigns (direct mail, TV, email, radio, etc.) to include when reviewing the performance of past … As a VP Marketing, I want to review the performance of historical promotional campaigns so that I can identify and repeat profitable ones. Clearly an epic Epics??? 17
  • 18.
    © Copyright MountainGoat Software ® As a VP Marketing, I want to see information on direct mailings when reviewing historical campaigns. As a VP Marketing, I want to see information on TV ads when reviewing historical campaigns. As a VP Marketing, I want to see information on email ads when reviewing historical campaigns. 18
  • 19.
    © Copyright MountainGoat Software ® Agenda What stories are Writing user stories Why user stories 19
  • 20.
    © Copyright MountainGoat Software ® Logging in •See how many user stories you can write about logging in. •Examples: •As a registered user, I am required to log in so that I can access the system. •As a forgetful user, I can request a password reminder so that I can log in if I forget mine. “As a <user role>, I <want/need/can/ etc> <goal> so that <reason>.” 20
  • 21.
    © Copyright MountainGoat Software ® Story-writing workshops Includes whole team plus possibly some external stakeholders Typically not done every sprint Brainstorm to generate stories Goal is to write as many stories as possible Some will be “implementation ready” Others will be epics No prioritization at this point 21
  • 22.
    © Copyright MountainGoat Software ® Start with epics and iterate As a frequent flyer, I want to book a trip using miles. As a frequent flyer, I want to rebook a trip I take often. As a frequent flyer, I want to request an upgrade. As a frequent flyer, I want to see if my upgrade cleared. As a frequent flyer, I want to see check my account. As a frequent flyer, I want to book a trip. As a frequent flyer, I want to… Frequent Flyer 22
  • 23.
    © Copyright MountainGoat Software ® Agenda What stories are Writing user stories Why user stories 23
  • 24.
    © Copyright MountainGoat Software ® So why user stories? If requirements are written down The user will get what she wants then At best she’ll get what was written“You built what I asked for, but it’s not what I need.” Shift focus from writing to talking 24
  • 25.
    © Copyright MountainGoat Software ® Words are imprecise Entrée comes with soup or salad and bread. • (Soup or Salad) and Bread • (Soup) or (Salad and Bread) Which is right? 25
  • 26.
    © Copyright MountainGoat Software ® Examples The user can enter a name. It can be 127 characters. The system should prominently display a warning message whenever the user enters invalid data. • Must the user enter a name? • Can it be other than 127 chars? • What does should mean? • What does prominently display mean? • Is invalid data defined elsewhere? 26
  • 27.
    © Copyright MountainGoat Software ® Additional reasons Stories are understandable Developers and customers understand them People are better able to remember events if they are organized into stories† Support and encourage iterative development Can easily start with epics and disaggregate closer to development time †Bower, Black, and Turner. 1979. Scripts in Memory for Text. 27
  • 28.
    © Copyright MountainGoat Software ® Yet more reasons Stories are the right size for planning Stories support opportunistic development We design solutions by moving opportunistically between top-down and bottom-up approaches† Stories support participatory design †Guindon. 1990. Designing the Design Process. 28
  • 29.
    © Copyright MountainGoat Software ® What if we had stories instead? 29
  • 30.
    © Copyright MountainGoat Software ® Most importantly… The story text we write on cards is less important than the conversations we have. Don’t forget the purpose 30
  • 31.
    © Copyright MountainGoat Software ® [email protected] www.mountaingoatsoftware.com twitter: mikewcohn (720) 890-6110 Mike Cohn 31