← ~/blog

Writing a PRD That Engineers Actually Read Past the First Heading

 /  product  /  290 words

I have written PRDs as a product owner and ignored them as an engineer, so I know exactly where readers stop: the moment the document starts describing the solution in a tone that suggests the thinking is finished.

Engineers read a PRD looking for two things. What problem is this, really, and what decisions are still mine to make. A document that answers both gets read. A document that opens with three paragraphs of market context and then specifies button placement gets skimmed, and the engineer rebuilds the actual requirements from Slack questions, which is the failure mode PRDs exist to prevent.

The structure that has worked for me. Lead with the problem, evidenced, one paragraph. Not "users want bulk editing" but "support gets 40 tickets a month from people editing records one at a time, here are three verbatim." Verbatims do more than any persona. Then success criteria, measurable, so everyone knows what done means beyond shipped. Then constraints, the true ones only, must work for the EU launch, cannot touch the billing service this quarter. Constraints are respected exactly as far as they are believed, so publishing fake ones devalues the currency.

Then, and this took me embarrassingly long, an explicit non goals section and an open questions section. Non goals kill scope debates before they start. Open questions are an invitation, here is where your judgment is wanted, and they are the difference between handing engineers a spec and handing them a problem. People do their best work on problems.

Keep it under two pages. The PRD is not the record of your thinking, it is the interface to it, and interfaces are judged by what they let the caller do, not by how much they contain.