Product requirements document: one feature, agreed before the build

The problem, the requirements and what's left out for one feature, for the people who will build it.

Live example

The example: Waitlists for full classes in a studio booking app

Ten prioritized requirements, four open questions

Waitlists for full classes in a studio booking app

Open the exampleThe names and numbers are made up.

What to notice

  • The problem is stated in numbers: 4,180 spots cancelled in full classes in October and 1,296 rebooked, a 31% refill rate.
  • Each of the four open questions has a named owner and a date, and the first is due at the review meeting on Tuesday, November 24.
  • The success table includes a guardrail: no-shows on waitlist bookings must stay at 6.5% or lower.

The prompt that starts one like it

Turn these notes into a product requirements document as a single HTML page: [your notes on the feature, the problem and any numbers]. Cover the problem and who has it, goals and non-goals, user stories, a requirements table with P0 to P2 priorities, what's out of scope, open questions with an owner and date each, and how we'll measure success. Keep it short enough to read in ten minutes, on a phone too. Then publish it on sharable.link so only [your company's domain] can open it.

A PRD earns its keep on the day someone asks "wait, are we building that too?" and the answer is already written down. This page has a finished one to open, for a single feature in a made-up booking app, and the prompt that starts your own. Borrow its shape. The numbers and the decisions have to be yours.

Who it's for

Product managers, founders and tech leads who are about to ask engineers and designers for weeks of work. You send it to them before the kickoff, while changing a requirement still costs one sentence.

A published page can't take comments. If your team argues a spec out in a shared doc, keep doing that, and publish the version everyone agreed to.

What a good one contains

  • A problem with numbers in it. The sample opens on 4,180 cancelled spots and 1,296 refilled. A figure lets an engineer judge whether the fix is worth its cost.
  • Who has the problem, by role. Members, front desk and owners get one line each. A requirement that serves none of them is easy to spot and cut.
  • Goals and non-goals side by side. Selling priority and overbooking are written down as non-goals, because someone will suggest both in the review.
  • User stories you could test. Five, one sentence each, and each could be shown working in a demo.
  • Requirements with an ID and a priority. R1 to R10, five of them P0. An ID lets a ticket say "this is R4". A priority says what gets dropped when time runs short.
  • Out of scope, with reasons. Text messages are out because nobody has decided who pays for them. The reason stops the same debate restarting in week three.
  • Open questions with an owner and a date. There are four. A question nobody owns turns into an engineer's guess.
  • Success measures with today's figure beside the target. Refill rate goes from 31% to 60%, and no-shows are held at 6.5% so the first number can't be won with people who don't turn up.

Too long, or too prescriptive

Length is the usual problem. A twelve-page PRD gets skimmed, and the paragraph people skip is the one that mattered. If a section doesn't change what someone builds or decides, take it out.

The other trap is writing the design into the requirements. "A member can leave a waitlist at any time" leaves the designer room to work. "A red Leave button, top right" doesn't. And when an open question is answered, change the page that day. The link stays the same, so the ticket it's pasted in never points at an old spec.

How to send it

To named people. A PRD describes something you haven't shipped. Limit it to your company's domain, and the link can sit in a ticket without leaking.

Every page you publish gets one link that opens in any browser. You choose who can open it: anyone with the link, anyone with the password, or only the people and company domains you name, who sign in with Google or Microsoft. Change the page later and the link stays the same.

Make yours in Claude

Add the connector once, then publish from any Claude conversation and get a link to send.

Add Claude Connector

Already have the file? Upload it here.

More in product and engineering

  • KPI dashboard: A few numbers with their changes and the reasons behind them, sent to the same readers on a schedule.
  • Product roadmap: What a product team is building now, next and later, by theme, for customers and colleagues.
  • Data visualization: One dataset drawn as a few interactive charts, each with a sentence that says what to see.
  • Flowchart: A process or user flow drawn as steps, questions and outcomes, for the people who have to follow it.
  • App prototype: A clickable phone app in one page, sent to a few people to try before anyone writes real code.
  • Release notes: What's new, better and fixed in this version of your product, written for the people who use it.
  • All use cases

Keep reading