Article · 10 min read

User Stories with Examples and a Template

Atlassian · Atlassian Agile Coach Free Beginner

A plain, practical guide to the as a user, I want, so that format that lets you describe features without a shred of technical knowledge. It gives you a repeatable sentence for each action a user takes, which is a natural way to list the must have actions for version one. Good, unglamorous reference material to keep open while you draft.

  • Write features as as a [user] I want [goal] so that [reason]
  • Keep each story small and centered on one user action
  • Stories describe intent, the developer decides the implementation
Open on atlassian.com ↗

The question it answers

  1. How do I write a spec for a developer when I'm not technical?

Read with it

  1. Basecamp's battle-tested, opinionated system for shipping meaningful work in fixed cycles without endless backlogs, a primary... Basecamp / 37signals Book · free online book Shape Up: Stop Running in Circles and Ship Work that Matters Ryan Singer
  2. Michael Seibel, who ran YC, makes the blunt case for shipping something almost embarrassingly simple and learning from real... Y Combinator Startup Library Video · ~10 min video How to Build an MVP Michael Seibel
  3. Figma's free plan is genuinely enough to design, tweak, and export a full logo set (SVG for print, PNG for the web) without... Figma Tool · Ongoing tool Figma (free plan) Figma
  4. The creator of Shape Up talks through fixing the time and cutting the scope, which is exactly the discipline that keeps an MVP... Lenny's Podcast Podcast · 90 min A Better Way to Plan, Build, and Ship Products (Shape Up) Ryan Singer
  5. This is the clearest statement of the exact idea in our answer: a spec describes how the product works entirely from the user's... Joel on Software Essay · 10 min read Painless Functional Specifications, Part 2: What's a Spec? Joel Spolsky
  6. Part 2 tells you what a spec is, this one covers who writes it and how they build agreement without authority, walking through... Joel on Software Essay · 12 min read Painless Functional Specifications, Part 3: But... How? Joel Spolsky
eChai Partner Brands The partnership →