Article · 8 min read

How we accidentally invented Job Stories

Paul Adams · Intercom Blog Free Intermediate

A simple, powerful sentence template for describing what a user is trying to do: when [situation], I want to [motivation], so I can [outcome]. It keeps you focused on the user's intent and the moment they hit it, which is precisely the plain language your developer needs. Intercom fits its whole feature brief on one printable page built around these, a format you can steal directly.

  • Frame each need as when I want to so I can
  • Anchor features to the situation that triggers them
  • One page of job stories can brief an entire feature
Open on intercom.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 →