Beyond Requirements
Beyond Requirements
Kent J. McDonald
Illustrations by Jeff Rains
For questions about sales outside the U.S., please contact [email protected].
Visit us on the Web: informit.com/aw
Library of Congress Cataloging-in-Publication Data
McDonald, Kent J.
Beyond requirements : analysis with an agile mindset / Kent J. McDonald ; illustrations by Jeff Rains.
pages cm
Includes bibliographical references and index.
ISBN 978-0-321-83455-3 (pbk. : alk. paper)—ISBN 0-321-83455-0
1. Decision making. 2. Requirements engineering. 3. Business requirements analysis. I. Title.
T57.95.M384 2016
658.4’0354—dc23
2015022866
Preface.................................................................................................................................xv
Acknowledgments........................................................................................................xxv
About the Author........................................................................................................xxvii
Part I: Ideas.............................................................................1
Chapter 1: Guiding Principles......................................................................................3
Introduction........................................................................................................................3
Deliver Value......................................................................................................................4
Collaborate..........................................................................................................................5
Iterate....................................................................................................................................7
Simplify.................................................................................................................................8
Consider Context..............................................................................................................9
Decide Wisely..................................................................................................................10
Reflect and Adapt..........................................................................................................11
Conclusion........................................................................................................................12
If You Remember Nothing Else........................................................................12
Chapter 2: Helpful Concepts......................................................................................15
Introduction.....................................................................................................................15
Needs and Solutions.....................................................................................................15
Outcome and Output....................................................................................................19
Discovery and Delivery..............................................................................................20
If You Remember Nothing Else........................................................................23
Chapter 3: Influence of Lean Startup.....................................................................25
Introduction.....................................................................................................................25
Customer Development..............................................................................................25
Build-Measure-Learn...................................................................................................29
Metrics................................................................................................................................31
Good Metrics..............................................................................................................32
vii
vi CONTENT
An Example.......................................................................................................125
When to Use It.......................................................................................................126
Why Use It................................................................................................................126
How to Use It..........................................................................................................126
Caveats and Considerations.............................................................................129
Additional Resources..........................................................................................129
Commitment Scale.....................................................................................................129
What It Is..................................................................................................................129
An Example.......................................................................................................129
When to Use It.......................................................................................................130
Why Use It................................................................................................................130
How to Use It..........................................................................................................131
Caveats and Considerations.............................................................................132
Additional Resource............................................................................................132
User Modeling..............................................................................................................133
What It Is..................................................................................................................133
An Example.......................................................................................................133
When to Use It.......................................................................................................135
Why Use It................................................................................................................135
How to Use It..........................................................................................................136
Caveats and Considerations.............................................................................137
Additional Resources..........................................................................................137
Persona............................................................................................................................138
What It Is..................................................................................................................138
An Example.......................................................................................................138
When to Use It.......................................................................................................139
Why Use It................................................................................................................139
How to Use It..........................................................................................................139
Caveats and Considerations.............................................................................140
Additional Resources..........................................................................................140
Chapter 12: Understanding Context.....................................................................141
Introduction..................................................................................................................141
Purpose-Based Alignment Model........................................................................142
What It Is..................................................................................................................142
The Quadrants Explained.................................................................................143
An Example.......................................................................................................144
When to Use It.......................................................................................................145
Why Use It................................................................................................................145
CONTENT xi
Problem Statement....................................................................................................167
What It Is..................................................................................................................167
An Example.......................................................................................................167
When to Use It.......................................................................................................168
Why Use It................................................................................................................168
How to Use It..........................................................................................................168
Caveats and Considerations.............................................................................169
Additional Resource............................................................................................169
Chapter 14: Understanding the Solution(s)......................................................171
Introduction..................................................................................................................171
Impact Mapping...........................................................................................................173
What It Is..................................................................................................................173
An Example.......................................................................................................173
When to Use It.......................................................................................................174
Why Use It................................................................................................................176
How to Use It..........................................................................................................176
Caveats and Considerations.............................................................................177
Additional Resources..........................................................................................177
Story Mapping..............................................................................................................177
What It Is..................................................................................................................177
An Example.......................................................................................................178
When to Use It.......................................................................................................178
Why Use It................................................................................................................178
How to Use It..........................................................................................................180
Caveats and Considerations.............................................................................182
Additional Resources..........................................................................................182
Collaborative Modeling............................................................................................182
What It Is..................................................................................................................182
An Example.......................................................................................................183
When to Use It.......................................................................................................184
Why Use It................................................................................................................186
How to Use It..........................................................................................................186
Caveats and Considerations.............................................................................188
Additional Resources..........................................................................................188
Acceptance Criteria....................................................................................................188
What It Is..................................................................................................................188
An Example.......................................................................................................189
When to Use It.......................................................................................................190
CONTENT xii
Definition of Done...............................................................................................211
What It Is..................................................................................................................211
An Example.......................................................................................................211
When to Use It.......................................................................................................211
Why Use It................................................................................................................211
How to Use It..........................................................................................................212
Caveats and Considerations.............................................................................212
Additional Resources..........................................................................................213
System Documentation............................................................................................213
What It Is..................................................................................................................213
An Example.......................................................................................................214
When to Use It.......................................................................................................214
Why Use It................................................................................................................214
How to Use It..........................................................................................................215
Caveats and Considerations.............................................................................215
Additional Resources..........................................................................................217
References......................................................................................................................245
Index.................................................................................................................................249
Preface
• Understanding stakeholders
• Understanding context
• Understanding the need
• Understanding the solution(s)
• Organizing and persisting solution information
xv
xvi PREFACE
While these problems certainly exist, merely using the word project does not
ensure that they will happen. I reasoned that most people are familiar with the
idea of the project, and it would be more useful to explain that these patterns
are antipatterns and it’s possible for projects to work differently than to use a
new term for an existing concept and deal with all of the confusion that could
cause. As Deanna, one of my editors, suggested, I should just “own it” when it
comes to using the word project.
xvii PREFA
some tech- niques that are very helpful for using analysis in an agile setting.
xx PREFA
Part I: Ideas
The first section takes a look at some key ideas that I consider essential for
effectively performing analysis in an agile setting. These include the concepts
that describe an agile mindset, and some helpful concepts from outside tradi-
tional analysis thinking that supplement typical analysis techniques. Finally, I
build on those ideas to place analysis techniques in context.
• Deliver value
• Collaborate
• Iterate
• Simplify
• Consider context
• Decide wisely
• Reflect and adapt
• Customer development
• Build-Measure-Learn
• Metrics
• What it is
• An example
• When to use it
• Why use it
• How to use it
• Caveats and considerations
• Additional resources
the people whose needs you are trying to satisfy—better known as stakeholder
analysis. The other two techniques in this chapter will help you better under-
stand the people who are actually going to use the solution you deliver; let’s call
this user analysis. The techniques I cover include
• Stakeholder map
• Commitment scale
• User modeling
• Persona
• Decision filters
• Project opportunity assessment
• Problem statement
xxi PREFA
• Impact mapping
• Story mapping
• Collaborative modeling
• Acceptance criteria
• Examples
• Discovery board
• Definition of ready
• Delivery board
• Definition of done
• System documentation
Glossary
It’s always a good practice to establish a common language for your projects.
Since I am trying to be very specific about how I refer to certain concepts, and
PREFACE xxv
in the interest of eating my own dog food, I decided to establish a glossary for
Beyond Requirements. This should help me be consistent in my use of certain
words, or at least give you a chance to catch me if I am inconsistent. Words in
the glossary appear in bold the first time they are mentioned in the text.
References
Throughout the book I reference several great sources of additional informa-
tion about the topics I discuss. This section compiles all the references into a
single list. Take some time to check out the references listed here; there’s some
great stuff.
In addition to the resources included in the book, beyondrequirements.com
features additional thoughts on analysis with an agile mindset, new technique
briefs, and updates to the material in the book.
xxv PREFA
Acknowledgments
This is not the first book I have written, but it is the first I took on by myself, or
at least that’s what I thought the case was when I started. It turns out that while
I’ll be listed as the only author, this book would not have been possible without
the help of several people.
There are two people who played the biggest part in how the book looks
and reads. Jeff Rains created all the hand-drawn graphics in the book. It was
important that the graphics reinforce the idea of having a conversation at a
whiteboard. Jeff’s great work allowed me to get that message across while
allowing you to be able to read the graphics. Deanna Burghart provided the first
line of defense that prevented me from doing horrendous things to the English
language. I have worked with Deanna for several years as she edited my pieces
for ProjectConnections.com. I knew when I started working on this book a . .
. um . . . couple of years ago that I wanted her editorial help. She, as always,
did a great job helping me sound like me.
I have been fortunate in my professional life to work and interact with
brilliant people who look at things in a slightly different way and who do not
hesitate to share their perspective with me. Several of those people played a
part in this book, but it’s important that I thank three especially. It is truly an
honor and a privilege to be able to fall back on these three to discuss ideas and
ways to describe them. Gojko Adzic’s extensive review notes were an immense
help during the editing stage and helped me see things from a different and
better perspective. Todd Little reviewed most of the book during the final
editing stages and, as always, provided practical and insightful advice to help
me crystallize my revisions. Chris Matts, long a primary source of cutting-edge,
yet eminently practical thought in the space of analysis, generously discussed
several ideas for this book and was a key source of many of the more important
ones. My understanding of the nuances of analysis and IT project work is due
largely to being fortunate enough to know these three practitioners.
I was fortunate to receive feedback from a wide range of professionals.
Special thanks go to Robert Bogetti, Sarah Edrie, James Kovacs, Chris Sterling,
and Heather Hassebroek for reading and commenting on the entire draft. Their
comments were very helpful in shaping and refining my initial thoughts into
something that I hope is a bit more coherent. Thanks also to Diane Zajac-
Woodie, Deb McCormick, Brandon Carlson, Mary Gorman, Julie Urban,
xxv
xxvi ACKNOWLEDGMENTS
Pollyanna Pixton, Matt Heusser, Tina Joseph, and Ellen Gottesdiener, who all
gave feedback on aspects of the draft.
Finally, thanks to Chris Guzikowski, acquisitions editor at Addison-Wesley,
who had the patience to stick with me through the drawn-out writing process,
and Jeffrey Davidson, who didn’t let an opportunity go by without nagging me
about finishing the book. Jeffrey, I’m not sure if Chris put you up to that or not,
but I suspect he’s glad you did, regardless.
About the Author
xxvii
This page intentionally left blank
Chapter 8
Introduction
McMillan Insurance is a midsize health insurance company located in a midsize
city in the middle of the United States. McMillan has grown through acquisition,
and until recently one of its practices was to let each company keep its own
iden- tity when dealing with anyone outside the walls of headquarters. This
included the relationships with independent agents and the resulting
commission struc- tures. This meant that Arthur, the manager of the
commissions area, had to deal with a slew of different very unique commission
rules down to the individual agent level, and the resulting hodgepodge of
commission “systems” required to administer those different commission plans.
McMillan has finished its acquisi- tion binge and now realizes that some
commonality needs to be introduced in many areas, including commissions.
Arthur was charged with making the commissions area more efficient, so his
first instinct was to find a new commission system that would allow him to
administer all the various commission plans in one place, while still maintaining
all the unique commission structures. He sat down with a couple of more expe-
rienced members of his staff, and they started scouring the Internet for possible
products. A quick search revealed several options. (Of course, this should have
been obvious just from the seven different software applications McMillan had
inherited from the acquired companies, only one of which was built in-house.)
It was at this point that they reached out to IT for some help figuring out
what to do. Arthur was a little hesitant to do that at first because he was
concerned that IT would want to build something in-house. He was pleasantly
surprised when Heather, a business analyst from IT on the team, suggested that
instead of immediately going out and looking for specific products they should
step back
95
9 CHAPTER 8 CASE STUDY: COMMISSION
and think about what need they were trying to satisfy. Heather and Arthur sat
down to discuss the current situation and what Arthur hoped to accomplish.
The Need
As a result of their conversation, Arthur and Heather identified the following
objectives:
• Reduce the time it takes to produce commission payments from one week
to two days.
• Reduce the time required to set up a new commission plan from six weeks
to one week (needed every time a new product is created).
• Reduce the time required to set up a new agent from one day to one hour.
Characteristic
Required/
Optional
Accept inputs from multiple policy systems to determine commissions. Required
Create unique commission rules for each individual agent. Required
Support multiple hierarchies: some sales channels are organized Required
based on product, others are based on geography, some are based on
both product and geography.
Allow for adjustments to occur in the calculated commission rules. Required
Allow for manual determination of commission payments. Required
Create unique commission rules based on free-form attributes and Optional
specific values of those attributes.
Support multiple commission rules unique to the individual, unique to Optional
the policy.
impact mapping (Chapter 14) to help them identify options. Several options
came up, including simplifying the commission rules and consolidating the mul-
tiple commission systems into one. The team also identified multiple options for
dealing with the existing systems:
The team decided that the best route was to start with simplifying the rules
for commissions in one of the acquired companies to see if there was any impact
on sales. At the same time, they started the search for software to replace all of
the existing commission systems. Table 8.1 lists the characteristics that served
as criteria for the search.
The team included the optional characteristics as a way of seeing if any com-
monly used applications used complex rule logic, in case they found data to
support the need for unique commission rules.
sure how many rounds they would have at the beginning, but they knew they
would be organized along the lines shown in Table 8.2.
The team figured that after the first couple of rounds they would simplify
rules and move the units to the new commission system at the same time. They
staggered the first few so that they could isolate the changes and get a sense of
what impact those changes had on sales.
Lessons Learned
The effort is still going on at the time of this writing, but the team has already
learned several lessons:
Not all problems require a technical solution. The team found that simplifying
the commission rules helped reduce the amount of time required to process
commissions a great deal and confirmed their suspicions that unique rules did
not have a large impact on sales agent behavior. Even so, the team decided it
would be good to consolidate all the processing on a single system.
You may not realize how good you have it on your side of the fence . As the
team started their search for a new commission system, they decided to include
the five purchased systems they were already using to administer parts of their
commissions. They found that as a result of simplifying commission rules, one
of the systems they already had fit the bill nicely for what they were trying to
do. They had to upgrade that commission system several versions, but once
they
LESSONS LEARNED 99
did, they found that their work mainly consisted of creating new interfaces for
any data they didn’t have in that system already.
Commercial off-the-shelf (COTS) systems often contain good industry practices.
When the team picked the commission system, they found they could use that
unit’s commission process for all the other units as well. That process was one
suggested by the developers of the existing commission system. Switching to
that process for all the units provided even more improvement in overall com-
missions processing and eased the transition effort since the team didn’t have to
come up with new processes for each unit.
Don’t forget change management. Just because the team didn’t have to come
up with new processes didn’t make the change completely turnkey. The com-
missions team did not have much trouble with the change, since over half of the
team was involved on the project to switch commission systems, but they had
a bit of change management to do with the agents. When they found out that
commission structures were changing, most of the agents complained. Loudly.
The team found that the best way to help the agents adapt to the change was to
give them examples of their own commissions under both the old and the new
structures. Most of the agents found that their commissions would stay con-
sistent, or even increase. The only agents whose commissions decreased were
those few who had studied the old plans enough to use loopholes to maximize
their revenue. These agents were among the highest compensated but were
only middle of the pack in terms of actual sales.
Don’t overlook interdependencies with other efforts. The team originally
thought they would have to do a lot of work to interface with a new set of
systems for each unit they brought onto the new commission system. Shortly
into the project, the team caught wind that the accounting and new business
systems were also undergoing projects to make things more uniform. The
commissions team got together with the other two teams and synced their
rollout plans so they affected the same units in the same order, though not
necessarily at the same time. That meant that the commissions team did not
have to build new interfaces for every additional unit; they just had to revise the
ones they had already built.
This page intentionally left blank
Index
A
The Agile Culture: Leading through
Acceptance criteria
Trust and Ownership, 150
“On Acceptance Criteria for User
Agile mindset. See Analysis, with an
Stories,” 192
Agile mindset
“Acceptance Criteria vs. Scenarios,”
“Agile Models Distilled: Potential
192
Artifacts for Agile Modeling,” 188
additional resources, 192
Agile Project Leadership Network
appropriate use of, 190
(APLN), 12
caveats and considerations, 191–192
Agreed upon, characteristic of objectives,
definition, 188–189, 221
18
example, 189–190
Ambler, Scott, 140,
Growing Agile: A Coach’s Guide to
217 Analysis
Agile Requirements, 192
cognitive bias. See Cognitive bias,
guidelines for expressing business
analysis
rules. See RuleSpeak
of discovery and delivery, 20–23
mind map of, 189
of needs and solutions, 15–19
potential criteria, 190
of outcomes and outputs, 19–20
process description, 190–191
scope of, xv
purpose of, 188, 190
Analysis, with an Agile mindset
RuleSpeak, 191, 192
decision filters, identifying needs, 71
in system documentation, 216 delivery boards, 73
“On Acceptance Criteria for User diagram of, 70
Stories,” 192
information radiators, 73
“Acceptance Criteria vs. Scenarios,” 192
needs, identifying, 71
Acceptance test driven development. See
possible solutions, identifying, 71–72
Examples (Agile technique)
release backlog, 72–73
Actionable metrics
release planning, 72–73
appropriate use of, 36
story mapping, 72
definition, 221
user stories, 72–73
purpose of, 34
visualization boards, 73
Adaptation, characteristic of initiatives,
Analyst. See Business analyst
11–12
Anchoring effect
“Adventures in Scaling Agile,” 177
cognitive bias, 51
Adzic, Gojko
definition, 221
examples (Agile technique), 62–63,
APLN (Agile Project Leadership
196 focusing on the desired outcome,
Network), 12
4 impact mapping, 174, 175–176, 177
Appropriate practices
Specification by Example, 62
vs. best practices, 9–10
Agile Alliance, 213
definition, 221
249
25 IND
mirror imaging, 50
definition, 129, 224
mitigating, 49, 50
example, 129–130
observer-expectancy effect, 50
process description, 131–132
response bias, 49
purpose of, 124, 130
Cohn, Mike, 137
Rath & Strong's Six Sigma
Collaboration
Pocket Guide, 132
characteristic of initiatives, 5–7
Commitments vs. options, 46–47. See
vs. consensus, 6
also Real Options
definition, 224
Communicating a decision, 45–46
examples, 6
Company building, definition, 26, 224
teams vs. workgroups, 6
Company creation, definition, 26, 225
Collaborative modeling
Competitive Engineering, 18
additional resources, 188
Complexity attributes, Context
“Agile Models Distilled: Potential Leadership Model, 151
Artifacts for Agile Modeling,” 188 Complexity risks, mitigating, 156
appropriate use of, 184–186 “Comprehensive Documentation Has Its
caveats and considerations, 188
Place,” 217
context diagrams, 183
Conference organizing, case study, 58
data dictionaries, 183
Conference submission system. See Case
definition, 182–183, 224 studies, conference submission
example, 183–184 system
functional decomposition, 183 Confirmation bias. See also Observer-
glossaries, 183 expectancy effect
“Inclusive Modeling: User Centered definition, 225
Approaches for Agile Software description, 50
Development,” 188 Consensus, decision mechanism
logical data models, 183 vs. collaboration, 6
organization charts, 183
definition, 225
process description, 186–187
description, 41
process flow, 183
Constraint, attribute of objectives, 18
purpose of, 186 Context
report mockups, 183 in the BACCM, 16
state transition diagrams, 183, 184 characteristic of initiatives, 9–10
techniques, 183 definition, 225
value stream maps, 183 Context diagrams
wireframes, 183 collaborative modeling, 183
Commercial off-the-shelf (COTS) definition, 225
systems, case study, 99 Context Leadership Model. See also
Commission system. See Case studies, Purpose-Based Alignment Model;
commission system Six questions
Commit to, transform, or kill,
advantages of a two-by-two matrix, 9
definition, 224
appropriate use of, 154
Commitment, 46
caveats and considerations, 156–157
Commitment: Novel about Managing complexity attributes, 151
Project Risk, 204 complexity risks, mitigating, 156
Commitment scale. See also Stakeholder definition, 150, 225
engagement example, 151–154
appropriate use of, 130
process description, 154–157
caveats and considerations, 132 purpose of, 155
25 IND
definition, 239
definition, 239
identifying (case study), 78
“get out of the building,” 28
identifying, with an Agile mindset, 71–72
talking to, 28
origins of, 19
types of, 123. See also specific types
separating from need, 19
Stand Back and Deliver: Accelerating
Solutions looking for problems, 119
Business Agility, 10, 147, 150,
Specific, characteristic of objectives, 18
157, 163
Specification by example. See Examples
Startup, 240. See also Lean startup
(Agile technique)
State transition diagrams
Specification by Example: How
collaborative modeling, 183, 184
Successful Teams Deliver the Right
definition, 240
Software, 196
Story mapping
Sponsors
additional resources, 182
definition, 239
during analysis, 72
as source of needs, 19
appropriate use of, 178
Spontaneous agreement decision
as a backlog visualization tool, 181
mechanism
case study, 79, 88–89
definition, 239
caveats and considerations, 182
selecting a decision mechanism, 42
definition, 177, 240
Stakeholder analysis
as an elicitation tool, 180–181
definition, 240
example, 178, 179
types of stakeholders, 123–124. See
Feature Injection, 60
also specific types
process description, 180–181
“Stakeholder Analysis,” 129
purpose of, 178
Stakeholder engagement. See also
User Story Mapping: Discover the
Commitment scale
Whole Story, Build the Right
high influence/high interest,
Product, 182
128 high influence/low interest,
Storyboards, definition, 240
128 low influence/high interest,
Strategy, definition, 240
128 low influence/low interest,
Strategy analysis, definition, 240–241
128
Stubbed identity service, 82
Stakeholder expectations, Feature
Student information system. See Case
Injection, 60–61
studies, student information system
Stakeholder maps
Subject matter expert (SME)
with actions, 127–128
definition, 241
additional resources, 129
in the development process, 12
appropriate use of, 126
Sunk cost bias, 52–53
caveats and considerations, 129
Survivorship bias
definition, 240
in analysis, 51
description, 124–125
definition, 241
engagement levels, 127–128
System documentation
example, 125
acceptance criteria, 216
primary outcomes, 125
additional resources, 217
process description, 126–128
appropriate use of, 214
purpose of, 126
backlog items, 216
“Stakeholder Analysis,” 129
“Best Practices for Agile/Lean
uses for, 124 Documentation,” 217
Stakeholders
business rule catalog, 213
in the BACCM, 16
caveats and considerations, 215–217
building support for decision making, 45
26 IND
Value points
definition, 242 W
in Feature Injection, 59 Waterfall planning technique,
identifying features, 59 20–21
Value stream maps “Who cares” activities
collaborative modeling, 183 definition, 242
definition, 242 Purpose-Based Alignment Model,
Van Cauwenberghe, Pascal, 58–59 144
Vanity metrics Williams, Walter, 47–48
appropriate use of, 36 Wireframes
definition, 242 collaborative modeling, 183
description, 34–35 definition, 243
Vision, shared. See Shared vision techniques Work groups
Visualization boards definition, 243
during analysis, 73 vs. teams, 6
definition, 242
Vlaskovits, Patrick, 26 Y
Yoskovitz, Benjamin, 32, 34, 37