Why Write Requirements

This content is syndicated from Tyner Blain by Scott Sehlhorst. To view the original post in full, click here.

old typewriter keyboard

There is a lot of advice out there for how to write requirements. There is not as much discussion about why to write requirements. Spend some time thinking about why you write requirements before you make decisions about how to write your requirements.

Why Write Requirements?

Whether you communicate requirements through conversation, user stories with acceptance criteria, or traditional structured requirements and use cases, or diagrams and commentary, you are sharing them as a means to an end – creating the right product.  Don’t just follow some prescription and go through the motions of documenting requirements.  Take a step back and consider the following goals for your requirements-writing.

  • Improve your understanding of what your market needs (from you).
  • Decide on the sequence in which you will deliver what you choose to build.
  • Collaborate with (and set expectations for) your engineering team.
  • Manage expectations with your stakeholders.
  • Improve the efficiency of your product-creation process.
  • Remember why your team created what they created.

Every team will place different emphasis on each of the above goals, depending on their unique situation. Each of the above goals could be the most urgent goal for your team. All things being equal, IMHO the goals are in order of descending importance.

Understanding Your Market

Understanding what your market needs is the most important goal supported by writing requirements, although writing requirements only indirectly contributes to your understanding. There isn’t a single standardized structure for capturing market understanding, every product manager has their own approach, ranging from “in your head” to sticky-notes and back-of-the-napkin drawings to canvases, mind maps, wikis, and big documents. What they have in common is that they all help the product manager with synthesis and analysis of information, informing decisions about what is important to deliver.

Throw-it-over-the-wall processes are flawed not only because they inhibit change, but because they impede feedback loops. The simple act of documenting requirements based on your understanding of market needs will identify opportunities to improve your understanding of your market. As you apply the rules of requirements completeness and correctness, you will discover that you are missing some information, and that some of your analysis is incomplete or flawed. Writing requirements creates the feedback loop that forces you to revisit and improve your understanding of your market.

Sequencing Delivery

Develop a point of view about what is important and what will be important to your market, specifically to your customers and prospective customers. Combine that with a vision or strategy for your company, specifically how your company intends to serve your market. Mix in a perspective about the competitive landscape, specifically how your competitors (alternative solutions your customers could choose) compete and will compete.

When your documentation of requirements identifies who’s goals you’re addressing, how much addressing that goal is worth to them – and to you, and the relative strategic importance, that documentation tells you the relative value of each “thing” you intend to build. This is a key contributor to the sequencing of what you build.

Collaborating with Delivery

I love the name of Jeff Patton’s company – Comakers. It communicates that discovering which problems are worth solving is a collaborative effort between the product manager and the engineering team. It is the solving of valuable problems that is interesting, not just the discovery of valuable problems worth solving. Requirements, expressed verbally, pictorially, or in prose, are part of that collaboration and communication. The intersection of value with feasibility, timing, and cost is what defines what your team can accomplish.

Note that sequencing decisions are usually tightly coupled with solutioning decisions. In other words, you cannot solve “when” and “how” independently, you have to solve for both, in the context of “why” simultaneously.

Managing Expectations

Stakeholders are better served when they know what to expect. Part of knowing what to expect is knowing the scope of what you intend – ideally communicated in terms of market needs, more commonly shared in terms of “what” and “how.” The requirements you communicate are a reflection of the “why” and are a key component of managing expectations. There is a lot more than this to managing expectations (for example, predicting “when”), but being able to say “these are the problems we intend to address” is a great place to start.

Improving Efficiency


Teams that start building without knowing why they are building will, by definition, build stuff that isn’t needed. Teams that ignore opportunities to get smarter about changing needs will also, by definition, build stuff that isn’t needed. The requirements you document enable teams to focus their efforts on what is needed. The cadence by which you update those requirements as you get smarter (learning more about your market, adapting to changes in your market, etc) and your team consumes those updates will impact the team’s ability to stay focused on a – by definition – moving target. The clarity of how you document and communicate your requirements impacts the effectiveness of your communication. All of these factors contribute to the efficiency of your team – and therefore to their capacity to create value. My experience has been that (with caveats for diminishing returns) small amounts of additional time following the rules of requirements avoid large amounts of time clarifying and re-communicating, freeing up more time for me to “get smarter” about my markets.

Remembering Intent

Enterprise software folks know full well that software applications can live for decades. We also know what it’s like to have no idea why a particular capability exists in a product, who uses it, how much value it provides, or what would happen if we improved (or removed) it. Now that software-as-a-service has gained traction, more and more consumer-facing products will have similar long life-cycles. When you document requirements – at the time of building things – don’t throw them out. Keep those requirements around, they will provide context later, after you’ve forgotten why you built something. This is particularly important for whoever takes over your job after you get promoted, or leave for a greener pasture.

Conclusion and More

Keep in mind why we write requirements. When considering how you will write requirements, think about the impact of different techniques on the goals that matter to you.

If you want to follow this approach at the next level of detail, check out The 8 Goals of Use Cases.

Post to Twitter Post to Facebook

Leave a Reply

What is 1 + 8 ?
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.”