Thinkr

Craft

What makes a good PRD (and how to know yours is one)

A good PRD is one your team can act on without you in the room. The qualities that define the bar — framed problem, falsifiable metrics, testable criteria — and how to measure against it.

Galang Aulia · 4 min read
Craft

A good PRD is one your team can act on without you in the room. It frames the problem before the solution, sets success metrics that can fail, writes requirements a tester could run, and says what it won't do. The test isn't length or polish. It's whether an engineer can estimate it and a stakeholder can decide on it, with you out of the building.

Most "how to write a PRD" advice measures the wrong thing. It counts sections and checks formatting, as if a complete-looking document were a good one. Completeness is table stakes. The bar is higher, and it's specific. Here's what actually separates a PRD that moves work forward from one that just looks finished.

It frames the problem before it names a solution

The single strongest signal of a good PRD is that you could read its first half, not know what gets built, and still agree it's worth building. The problem, the user, and the reason-now come first. The solution arrives as an answer to them, not as the thing the doc was secretly about all along.

This is the hardest one to fake, because a solution-first PRD reads perfectly well to everyone who already agreed with the solution. The product thinker Marty Cagan has spent years on a version of this point — that teams ship documents instead of doing the discovery the document is supposed to represent. A good PRD shows the thinking, not just the conclusion.

Its success metrics can fail

A metric that can't be wrong isn't a metric. "Increase engagement" names a direction and commits to nothing. The bar is a number someone could check and catch you out on: a baseline, a target, a deadline. Lift activation from 22% to 30% for new workspaces within one quarter. If it ships and the number holds flat, the PRD was wrong about something, and you'll know what.

Falsifiability is the whole game. The point of writing the metric down is to be accountable to it later, and you can only be accountable to a claim that could have gone the other way.

Its requirements are testable, not aspirational

"Handle errors gracefully" is a hope. "The system is fast" is a hope. A good PRD turns hopes into conditions a tester could run. For behavior, that's the Given-When-Then form borrowed from Gherkin: Given a user with a revoked invite, When they open the shared link, Then they see a request-access screen. For performance, it's a number, not an adjective: p95 under 500ms at 1,000 concurrent users.

The reason this matters beyond pedantry: every aspirational requirement is a decision you've quietly delegated to whoever builds it. "Fast" becomes whatever was easiest to ship. Testable requirements are how you keep the decision.

It covers how well, not just what

Most drafts describe the feature and go silent on its quality attributes, which is exactly where estimates fall apart. The recognized vocabulary here is ISO/IEC 25010, the international standard for software quality: performance efficiency, reliability, security, compatibility, maintainability, usability, and the rest. You don't have to name the standard in your doc. You have to answer the questions it implies. How many concurrent users? What happens under load? What's the security posture for this data? A PRD that skips the non-functional half hasn't described the product, only its demo.

It says what it won't do

Scope with only an in-scope list is half a scope. The good half is the boundary: the explicit set of non-goals that stops every reader from filling the gap with their own assumption. "We are not doing X in this version, because Y" prevents more rework than any amount of detail on what you are doing, and it forces you to own the tradeoff you already made instead of discovering it in the demo.

The marks, and where to go deep

Pull those together and a good PRD has a recognizable shape. It earns trust in the first half, commits to falsifiable outcomes, specifies behavior and quality in terms a team can act on, and draws its own edges. The Atlassian PRD guide and most serious treatments of the topic converge on the same core, even when they organize it differently.

If you want the standing version of these qualities as something to run against a draft, that's the PRD review checklist. If you want them as the failure modes to avoid, those are the common PRD mistakes, each tied to the thing that catches it. And if you want to apply the bar to your own draft before anyone else reads it, that's how to critique your own PRD.

The real test: could someone build it without you?

Strip away the rubric and one question decides it. Hand the PRD to an engineer who wasn't in any of the meetings, and a stakeholder who has to approve the spend. Can the engineer estimate the work without booking a call to ask you what you meant? Can the stakeholder decide yes or no without you in the room to defend it?

If both can, the document did its job: it carried your thinking to people who weren't there. If either can't, you've found exactly where the PRD is still living in your head instead of on the page. That gap is what a review is for, and the fastest way to find it is to run the eleven-pass critique on the draft before you send it, or to start upstream where the spec gets generated with the structure already in place.

New posts and release notes. No spam — unsubscribe anytime.

Stop shipping foggy PRDs.
Start the critique loop.

Three minutes to sign up. No credit card. Cancel by closing the tab.

Start freeSee pricing