GUIDE 2025

How to write a PRD: The way I’d actually do it

Josh Fechter
By
Josh Fechter
Josh Fechter
Josh Fechter
Josh Fechter is the co-founder of Product HQ, founder of Technical Writer HQ, and founder and head of product of Squibler. You…
More About Josh →
×

Once scope is clear, I make ownership explicit with a lightweight RACI for product managers so decisions do not stall between product, design, engineering, and support.

A PRD (product requirements document) should make building the right thing easier. If it only exists to survive a committee, it's already failing.

(Note: some older guides blur "PRD" and "roadmap." They're related, not the same. Roadmaps communicate intent over time; PRDs specify a problem/solution slice deeply enough to execute.)

What a PRD is

A shared artifact describing problem, users, goals, requirements, constraints, and success criteria for a product change—so design and eng can make good decisions without telepathy.

Components I'd include

  • Primary purpose / problem statement — who hurts, what's broken, why now
  • Goals & non-goals — protect scope
  • Users & scenarios — personas lightly; jobs and flows heavily
  • Requirements — functional + non-functional (perf, security, accessibility)
  • Design guidance — principles and references, not pixel dictatorship (unless needed)
  • System & environment notes — platforms, integrations, migration needs
  • Analytics — events needed to learn
  • Rollout / timeline intent — phases, feature flags, risks
  • Open questions — honesty > fake certainty

Who writes it? Usually the PM, with design/eng co-authors. Ownership can vary; clarity can't.

How I'd write one (phases)

Phase 1: research

Talk to users, read tickets, check data, review constraints with eng early.

Phase 2: purpose & characteristics

One-paragraph problem; success metrics; explicit non-goals.

Phase 3: user profile & critical journeys

Happy path + failure path. Include edge cases that explode support.

Phase 4: technical requirements

APIs, data, permissions, backwards compatibility. Invite an eng lead to pressure-test feasibility.

Phase 5: testing, support, compliance

QA scope, feature flag plan, support macros, legal/privacy if relevant.

Then: write short. Socialize. Decide. Update as you learn—version it.

My take

The best PRD is the thinnest document that prevents expensive misunderstanding. If eng still needs a meeting for every sentence, add examples and acceptance criteria—not adjectives.

I also keep a focused product requirements document guide for PMs to connect the problem, scope, requirements, and decision rules before build work begins.

For more on specs inside real product practice, see the Product Manager Certification and the newsletter.

Josh Fechter
Josh Fechter
Josh Fechter is the co-founder of Product HQ, founder of Technical Writer HQ, and founder and head of product of Squibler. You can connect with him on LinkedIn here.