Length is not the problem with most PRDs; the problem is that the sections
engineers actually need are the ones missing.
1 PROBLEM AND EVIDENCE half a page
Who has it, how you know, how often, what it costs them.
Cite the research: interview count, the funnel step, the ticket
volume. No solution language anywhere in this section.
Engineers read this to make the hundred small decisions you will
not be present for.
2 WHY NOW
What changed - a deadline, a competitor, a contract, a newly
available capability. If nothing changed, say so. This is the
section that survives a reprioritisation argument.
3 SUCCESS AND FAILURE
The metric, its current value, the target, and the date you will
read it. Then the number at which you would revert or stop.
Guardrails listed here, not discovered later.
4 SCOPE
In scope, as user-visible capability rather than as tasks.
OUT OF SCOPE, explicitly and generously - this is the highest
value section in the document and the one most often absent.
Deferred, with the condition under which it returns.
5 REQUIREMENTS AND RULES
The behaviour that is not negotiable, especially the unglamorous
parts: permissions, what happens to existing data, error and
empty states, limits, currency and locale, audit needs.
Every rule an engineer would otherwise have to guess or invent.
6 OPEN QUESTIONS, with an owner and a date against each
The section that makes the document honest. A PRD with no open
questions is either trivial or lying.
7 DEPENDENCIES AND RISKS
Other teams, vendors, legal or security review, data migration.
Named people, not team names.
8 LINKS
Designs, the technical design doc, the analytics spec, the
research. The PRD does not contain the solution - it points at it.
NOT IN A PRD: the schema, the API shape, the estimate, the sprint
plan, or the UI copy. Each of those is someone else's document and
putting it here means you will be arguing about the wrong thing.
The problem section carries the whole document. Its purpose is not to justify the
work to a reviewer but to give engineers and designers enough context to resolve
ambiguity themselves, and a PRD that opens with a solution guarantees a stream of
questions to you about every case you failed to anticipate.
Out of scope is the highest-leverage section and the one written last if at all.
Scope grows through reasonable local decisions — an edge case here, a settings
toggle there — and the only defence is having written down, before the work began,
what you were deliberately not doing. It also protects engineers, who otherwise
have to litigate each addition without a document behind them.
Section five is where PRDs are actually judged by engineers. Permissions, existing
data, error states, limits and locale are the requirements that get discovered in
the last week and cause the slip, and they are absent from most PRDs because they
are boring to write. A PM who reliably covers them earns latitude everywhere else.
Open questions with owners and dates are what distinguish a working document from a
performance. Ambiguity is normal at this stage; unnamed ambiguity is what turns into
a two-week stall, and writing "unclear whether we support multi-currency — Priya,
by 8 August" costs one line and removes a class of failure.