Home About Services Use Cases Resources Blog FAQ Book a Demo
← Back to resources

User Stories and Acceptance Criteria

Fenced scope, rerunnable tests: a user stories template any tester reads the same way

BABusiness AnalystCore tier8 sections

A user stories template turns a specified behavior into cards a delivery team can build in slices: an actor who is a named persona, a capability, the value, and the acceptance tests that prove the card is done. The decision it supports is the slice plan, starting with the walking skeleton, the thinnest end-to-end path that proves the whole loop works. Specira compiles the story set from the functional requirements it covers and the decisions that ordered them.

Hand-written stories name a generic user, cover three requirements at once, and carry acceptance criteria such as works correctly that two testers would read two ways. Boundary values never get a row, negative paths get forgotten, and the link back to the requirement lives in someone's head. The sprint delivers the card and nobody can say which behavior it actually proved.

What sections does the user stories artefact contain?

The governed default template groups stories by epic and feature, writes acceptance criteria in Given/When/Then form, sizes and orders them, draws the story map and enumerates edge-case, negative and cross-cutting stories.

SectionDepthHow it is produced
Epic SummarycoreProse synthesized from discovery
Stories Grouped by FeaturecoreTable from typed items · ID, Epic, Story, Priority, AC Summary
Given/When/Then ACstandardProse synthesized from discovery
Story Points & PrioritystandardTable from typed items · ID, Story, Story Points, Priority, Dependencies
Story Map VisualizationfullGenerated diagram
Edge Case StoriesfullProse synthesized from discovery
Negative Test StoriesfullProse synthesized from discovery
Cross-Cutting StoriesfullProse synthesized from discovery

How does Specira build the user stories?

The Business Analyst agent owns the story set, with the UX Researcher adding persona notes and the Red Team Critic flagging cards whose acceptance rows are vague. It is compiled from the functional requirements a story covers, the personas in the product requirements document and the slice decisions recorded in discovery. The Meridian sample's Epic Summary and Slice Plan section records the walking-skeleton decision, who agreed it and when, and maps each slice to a delivery milestone. Its Story Register section renders one card per story: a named actor, a scope fence that says what the card excludes, explicit preconditions, and acceptance rows with real values, an observable result, a path class and a test-case identifier.

Three validators guard the register: acceptance rows must carry concrete values, preconditions must be stated even when there are none, and every bounded input needs a boundary row. A story whose covering requirement is still open renders as a named gap. Each card cites the functional requirements document (FRD) scenario outlines it proves and carries provenance for the decisions behind it. The Red Team Critic gates export on decisions resolved; the story set then ships to Jira, Linear or GitHub, or as DOCX, Markdown and JSON.

First page of the sample: User Stories and Acceptance Criteria

Rendered sample

Rendered from the Specira governed default template on a fictional company, watermarked, with its diagrams. Read it in the browser or take the PDF.

PDFView online

How do teams use the user stories?

What do user stories look like inside Specira?

The screens below follow the assignment-recommendation story set from the slice decision in discovery to the cards pushed into the tracker.

Screens are from a seeded Specira demo workspace; counts and scores are sample data.

Book a demo and watch a user stories set compile from your functional requirements, acceptance rows included.

Book a Demo

What do teams ask about this artefact?

A user stories template defines how each card is written: an actor who is a specific role, a capability, the value it delivers, and acceptance criteria that prove the card is done. Specira's governed default adds an epic summary and slice plan, a story register with scope fences and preconditions, sizing and priority, a story map, and dedicated edge-case, negative and cross-cutting stories.
As concrete rows, not adjectives. Each row states a test instance with real values, the expected observable result, a path class such as happy, boundary or negative, and a test-case identifier. Validators reject rows without concrete values, require preconditions to be stated even when empty, and require a boundary row for every bounded input. Given/When/Then phrasing carries the scenario narrative.
From the product requirements document (PRD). The template forbids the generic user as an actor; every card names one of the PRD's personas, so the story inherits the persona's job to be done and current workaround. The UX Researcher agent adds inline notes during discovery when a card's actor or value does not match what the persona records say.
Yes. The story set exports to Jira, Linear and GitHub with identifiers, acceptance rows and dependencies intact, as well as DOCX for review and Markdown or JSON for agents. The export readiness gate runs first: it counts decisions resolved, and any story whose covering requirement is still open is listed in the gap report rather than pushed as if it were ready.
The thinnest end-to-end slice that proves the whole loop works, built before any refinement. In the Meridian sample it is three stories: see suggestions with reasons, accept one, record the assignment and notify the technician. The slice decision records who agreed the order and when, and later slices map to the milestones in the product requirements document's delivery frame.

Which artefacts go with this one?