Skip to content

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.

By Eric Muriel2 min read

The process at a glance

  1. Before

    Pending request and valid permission

  2. Action

    The person approves the request

  3. After

    The decision persists when reopened

Original diagram of this guide’s exercise.

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. [1] GOV.UK Service Manual

    Writing user stories ↗

    Describe the goal from the user’s perspective.

    Back to the related section
How we use sources, quotes and images

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.