Skip to content

Example PRD: README Improvement

A simple PRD for documentation cleanup tasks.


Make the README useful for a new developer within 5 minutes of opening the repo.

The current README is missing setup steps and verification commands.

PriorityRequirement
MustAdd one-sentence project summary at the top
MustDocument npm install and npm run dev
MustDocument npm test and npm run typecheck
MustKeep examples generic — no real tokens or secrets
ShouldPreserve existing license and attribution sections
ShouldKeep the README under 100 lines
  • A new contributor can copy-paste the setup commands and run locally
  • No credentials appear in examples
  • Commands match what’s in package.json
  • Only documentation files are changed
  • Code changes
  • CI configuration
  • Adding new dependencies