Skip to content
Glossary · Running a build

User story

Also called story.

Definition

A short description of a feature from the point of view of the person who needs it, and why they need it.

Last updated

What it is.

The common template is: as a [type of user], I want [to do something], so that [I get some benefit]. The "so that" matters most, because it tells the team what problem they are really solving.

A story is a placeholder for a conversation, not a full spec. The details go into acceptance criteria underneath it. Good stories are small enough to finish in one sprint and give some value on their own.

Why it matters

Stories keep the team focused on users and outcomes rather than technical tasks. They are easy to order in a backlog, easy to estimate, and easy for non-technical stakeholders to read and challenge.

In a product build

Stories are how a discovery scope turns into a backlog. Each milestone in a product build is a group of stories, each with its own acceptance criteria.

Watch out

Common mistakes.

  1. 01

    Writing technical tasks as stories ("as a developer, I want a database table").

  2. 02

    Stories so large they take several sprints. Split them by user step or by case.

  3. 03

    Dropping the "so that", which leaves the team guessing at the goal.

Related

Related terms.

Building something with this? Ask an engineer.

OceanLab designs and builds production software. Tell us what you are planning and we will reply with how we would approach it.

OceanLab

Enterprise Software Engineering - Human + AI

Languages

Locations

Global Headquarters

21 Merchant Road, 3rd Floor, Singapore 058267

Main corporate office and leadership operations

North America Office

548 Market Street, PMB 12472, San Francisco, CA 94104

Client operations and business development

India Office

402 Shivalik Shilp II, SG Highway, Ahmedabad 380015

Engineering and delivery center

© 2026 - Copyright. All Rights reserved OceanLab