May 2022

Main Posts Background Image

Main Posts Background Image

Saturday, May 7, 2022

The Million-dollar mistake that starts with a Bad Requirements

Imagine this: After nine months and $1.2 million, a software team proudly launches a new customer portal. On day one the CEO logs in, clicks “Export Report,” and watches the system grind for 45 seconds before returning… a CSV with last year’s data.

The room goes silent.

Turns out, someone had written the requirement as:
“Users should be able to export reports.”

That single vague sentence cost the company six figures in rework, lost trust, and a very uncomfortable all-hands meeting.

Why Requirements Are the Foundation Everything Stands On

Software projects fail for many reasons—bad code, shifting scope, underestimation—but almost all of those reasons can be traced back to poor requirements. Gartner still estimates that 40–60 % of defects originate in the requirements phase, and fixing them later is 50–200 times more expensive than fixing them early.


Good requirements are not just “documentation.” They are:

  • A contract between business and technology
  • The single source of truth for scope
  • The yardstick for “done”
  • The shield against endless scope creep

Yet most teams treat requirements gathering as a boring checkbox before the “real work” of coding begins.


What Proper Requirements Gathering Actually Looks Like

1. Start with Why, not What: Before you write a single user story, understand the business goal.
Bad: “We need a dashboard.”
Good: “Finance needs to reduce monthly close from 12 days to 5 days by spotting accrual errors on day two.”

2. Talk to the Right People—Repeatedly
The loudest voice in the room is rarely the person who will actually use the system. Schedule time with end users, support teams, compliance officers, and data owners. One 45-minute session with a subject matter expert can save weeks of rework.

3. Make Them Testable: If you can’t write an acceptance test for it, it’s not a requirement—it’s a wish.
Instead of: “The system should be fast.”
Write: “95 % of search queries return results in under 1 second under 500 concurrent users.”

4. Visualize Early: A sketch, wireframe or a quick prototype reveals misunderstandings faster than 1,000 words ever will. I’ve watched stakeholders completely reverse their position on a feature after seeing a clickable mockup that took two hours to build.

5. Keep Them Alive: Requirements are not a one-and-done artifact you throw over the wall. Review, refine, and retire them throughout the project. Living documentation (tools like Confluence, Microsoft Devops or Jira tickets) beat a 120-page specification that nobody reads.

The ROI Is Embarrassingly High

A classic study by Barry Boehm showed that every $1 invested in requirements activities saves $5–$10 later in the project. Capers Jones puts the number even higher in some domains.

In plain language: spending an extra week talking to users and writing clear, testable requirements can save months of arguments, rework, and emergency weekend deployments.

Final Thought

The most expensive feature you’ll ever build is the one you build twice because you didn’t understand what was needed the first time.

Invest in requirements like you invest in code reviews and automated tests—because in the end, they prevent far more pain than either of those practices ever could.

Your future self (and your budget) will thank you.

Error 404

The page you were looking for, could not be found. You may have typed the address incorrectly or you may have used an outdated link.

Go to Homepage