User Story Template

The standard user story format — As a [role], I want [goal], so that [benefit] — with Given/When/Then acceptance criteria.

Syntax

design-and-specify
As a [role],
I want [goal],
so that [benefit].

Given [precondition], when [action], then [outcome].

Example

design-and-specify
As a registered user,
I want to reset my password via email,
so that I can regain access if I forget my credentials.

Given I am on the login page,
when I click "Forgot Password" and enter my email,
then a reset link is sent to that address within 60 seconds.

Given the reset link has expired (>60 min),
when I click it,
then I see "This link has expired" with an option to request a new one.