Writing Requirements Specifications

  • Use process details such as use cases and user stories
  • Include data and interface details
  • Communicate requirements that are measurable and actionable

A requirements specification turns an approved, baselined requirement into something a development team can actually build from — written with enough process detail (a use case's step-by-step interaction, or a user story's short, outcome-focused format), data detail, and interface detail that nothing essential is left to guesswork. The choice between a use case and a user story usually tracks the project's overall methodology and the requirement's own complexity.

"Measurable and actionable" is the real bar here: a specification someone could read and reasonably disagree about what it means has failed this task, regardless of how much detail it contains — detail without precision doesn't actually make a requirement buildable.

Study focus: a scenario comparing a vague requirement ("the system should be fast") against a measurable one ("the system must return search results within 2 seconds for 95% of queries") is testing recognition of what "actionable" actually requires.

Key terms in this chapter

Use case · User story · Requirements specification · Measurable requirement

Previous: Obtaining Sign-Off on the Requirements Baseline · Next: Validating Requirements

Try the free PMI-PBA practice questions · Take the free PMI-PBA mock exam