AI for business · Practical guide
Write down how you will know a feature is finished.
“It should work well” does not define a test. This exercise turns request approval into observable examples so the builder and reviewer can compare the same outcome.
The process at a glance
Before
Pending request and valid permission
Action
The person approves the request
After
The decision persists when reopened
01Start with observable behaviour
Fictional requirement: approve a pending request. Describe the starting state, action and outcome: an authorised person opens REQ-01, selects approve and sees “approved” when reopening it.
Include persistence in the expected outcome. A button changing colour does not establish that the decision was saved. Check the data that matters to the process.
Reference [1]: GOV.UK Service Manual
02Add the feature’s boundaries
Describe missing permission, a request already decided and a failed save. In this exercise, an unauthorised person cannot approve, a resolved request shows its existing decision, and a failed save does not display false success.
Do not assume a mockup defines these behaviours. Agree on the message and the user’s next available action, then record them.
03Use a test record for each case
Copy: case identifier; initial state; person and permission; action; expected outcome; observed outcome; evidence; passed or pending. Use fictional data so the test can be repeated without affecting real work.
A screenshot can show a message, but reopening the request may be necessary to verify its state. Choose evidence according to the behaviour rather than convenience.
04Decide what prevents release
For this example, approval without permission blocks release. A wording improvement can be recorded separately if the responsible people accept it. Keep unresolved decisions visible.
Rerun affected cases after a correction. Do not close an issue merely because the code changed; check the outcome that prompted the issue.
Sources and further reading
These references expand on the concepts indicated. The examples and exercises are original editorial material.
[1] GOV.UK Service Manual
Writing user stories ↗
Describe the goal from the user’s perspective.
Back to the related section
Frequently asked questions
Must every criterion be an automated test?
No. You can start with repeatable manual checks. The expected outcome must be defined, with evidence that lets you decide whether it is met.
Keep reading
AI for business
How to write a brief for an internal application ↗
Define users, tasks, data and scope before building an app. Complete a practical brief using a fictional office-supply request.
AI for business
How to collect useful feedback on a prototype ↗
Run a short session around a task, observations and decisions. Turn general comments into changes you can check.
AI for business
Rules or AI? How to choose for an automation task ↗
Break down a business task, identify explicit rules and test where AI may help. Work through a request-routing example with a practical decision checklist.