Framework

Version your PRDs like you version code:

  • v1.0: Initial spec
  • v1.1: Bug fixes mid-build
  • v2.0: Post-launch changes
  • ARCHIVED: Old versions preserved for learning

Changelog Template

VersionDateAuthorChanges
v1.02026-04-01Priya (PM)Initial spec
v1.12026-04-08Mark (Eng)Added dark-mode edge case (found during design review)
v2.02026-05-01Priya (PM)Post-launch: changed success threshold from 80% to 75% due to user feedback

Key Takeaways

  • Versioning creates accountability. You capture what changed and why.
  • Archive = learning. "We assumed X in v1.0, learned Y in v2.0" improves future specs.