How-to

Write a requirement an agent can follow

One testable statement, the reason in plain words, and criteria that a test can check.

For: Product owner, Project lead

Checklist

  • Who is it for, and why does it matter (the objective it serves)?
  • How much: can it be measured? "Fast" is not a requirement; "under one second for 95% of loads" is.
  • How will we know: at least one acceptance criterion (required before Approved or Authority).
  • What it is not: say what is out of scope.

Example

WeakStrong
The app should be fast.Lists load in under one second (p95) with 1,000 records.
Users can manage bookings.A patient can move an appointment up to 2 hours before it starts.

KB-RA-12