Revision history

The Example PRD has 16 revisions over 20 days, from to .

The first draft was 21 KB across 32 sections. Revision 3 reduced it to 11 KB across 13 sections; later revisions restored detailed copy, mocks, and the specification checklist, bringing the current example to 25 KB. Open a revision to read the exact change.

Size at each revision

One bar per revision, length = file size in bytes; the highlighted bar is the revision the sample page shows.

Document size at each of the 16 revisions From 21.0 KB at revision 1 to 25.4 KB at revision 16; smallest 10.2 KB at revision 4, largest 26.3 KB at revision 11. Revision 16 is the one on the sample page. #1 #2 #3 #4 #5 #6 #7 #8 #9 #10 #11 #12 #13 #14 #15 #16 #1 · 21.0 KB · 2026-08-12 #2 · 22.7 KB · 2026-08-13 #3 · 11.3 KB · 2026-08-13 #4 · 10.2 KB · 2026-08-13 #5 · 10.5 KB · 2026-08-13 #6 · 11.4 KB · 2026-08-13 #7 · 20.9 KB · 2026-08-15 #8 · 21.1 KB · 2026-08-15 #9 · 24.5 KB · 2026-08-20 #10 · 25.9 KB · 2026-08-20 #11 · 26.3 KB · 2026-08-30 #12 · 24.3 KB · 2026-08-30 #13 · 24.9 KB · 2026-08-30 #14 · 25.4 KB · 2026-08-31 #15 · 25.5 KB · 2026-08-31 #16 · 25.4 KB · 2026-08-31 26.3 KB10.2 KB

Every revision

The 16 revisions of the gist, oldest first. + and − are GitHub's per-revision line counts (each revision's page diffs the text itself, so the two can differ by a line); then the file's size and section count, and which sections were added, changed or removed.
# Date + (GitHub) − (GitHub) KB Sections What changed View
1 790 0 21.0 32 First draft — 32 sections

First draft: The Urlist on Next.js and SQLite, with anonymous and account-owned lists, soft delete and restore, live metadata, QR codes and a mock GitHub login.

Diff Markdown GitHub
2 33 2 22.7 33 Added: Required design skill; Changed: Links, Tests

Adds a Required design skill section that mandates the Postrboard design language and makes drag-and-drop the primary way to reorder links.

Diff Markdown GitHub
3 122 726 11.3 13 Added: Stack and design, Routes, Draft and editor, Live metadata, Aliases and publication, Mock login and ownership, Delete and restore, Public list, Theme, responsive UI, and accessibility, Storage and security, Scripts, tests, and documentation; Changed: Intro, Product, Completion; Removed: Required design skill, Required technology, Required routes, Global navigation, Home page, Drafts, Link URL rules, Links, Live metadata enrichment, Metadata-fetch security, Alias rules, Publication, Anonymous publication, Mock GitHub login, Account-owned lists, My Lists, Delete, tombstone, and restore, Public list page, Sharing, QR code, Never-used aliases, Themes, Responsive behavior, Accessibility, State and error handling, Data and persistence, General security, Test reset, Required npm scripts, Tests, README

Condenses the whole document: one exact stack list, a five-row routes table, and the metadata, alias, login and accessibility rules cut to a paragraph each.

Diff Markdown GitHub
4 24 45 10.2 13 Changed: Intro, Product, Routes, Draft and editor, Live metadata, Aliases and publication, Mock login and ownership, Delete and restore, Theme, responsive UI, and accessibility, Storage and security, Scripts, tests, and documentation

Makes the server authoritative on every write, moves the edit and public routes to catch-all alias segments, and folds the reorder and test lists into prose.

Diff Markdown GitHub
5 4 3 10.5 13 Changed: Completion

Adds a Completion step: walk every user journey in a real Chromium browser before declaring the app done.

Diff Markdown GitHub
6 14 2 11.4 14 Added: Technical specification and checklist; Changed: Completion

Adds the Technical specification and checklist section: commit a spec with a verifiable checkbox per requirement and reconcile it before finishing.

Diff Markdown GitHub
7 125 79 20.9 16 Added: Home page, Login and ownership, My Lists, Delete; Changed: Intro, Stack and design, Product, Routes, Draft and editor, Live metadata, Aliases and publication, Public list, Theme, responsive UI, and accessibility, Storage and security, Scripts, tests, and documentation, Completion; Removed: Mock login and ownership, Delete and restore

Makes the reference Blazor app the source of truth: exact copy per screen, Bulma tokens, one-segment vanity routes, and permanent delete replacing soft delete.

Diff Markdown GitHub
8 23 36 21.1 16 Changed: Intro, Stack and design, Routes, Home page, Draft and editor, Login and ownership, My Lists, Public list, Theme, responsive UI, and accessibility

Reverses the styling call: the reference app now defines behavior and copy only, and every screen is restyled with Postrboard instead of Bulma and Font Awesome.

Diff Markdown GitHub
9 33 17 24.5 16 Changed: Intro, Routes, Draft and editor, My Lists, Public list, Theme, responsive UI, and accessibility, Scripts, tests, and documentation, Completion

Makes structure part of the UX: the publish bar is a full-width band, link rows are cards of plain text edited in place, and My Lists tiles get exact anatomy.

Diff Markdown GitHub
10 263 258 25.9 16 Changed: Home page; line endings CRLF → LF

Details the Home page layout: top-aligned columns, a hero of three cascading browser windows, and a full-bleed Get Started band with a full-width link input.

Diff Markdown GitHub
11 14 2 26.3 17 Added: Mocks; Changed: Intro

Adds a Mocks section with six screenshots of the reference app in place of the paragraph pointing at its source repository.

Diff Markdown GitHub
12 2 8 24.3 17 Changed: Intro, Stack and design, Routes

Drops Postrboard and the replicate-the-reference rules; the design system is now simply Bulma CSS with Font Awesome icons.

Diff Markdown GitHub
13 268 268 24.9 17 Changed: Stack and design, Home page, Draft and editor, Login and ownership, My Lists, Public list, Theme, responsive UI, and accessibility; line endings LF → CRLF

Spells out the Bulma choice: no second framework, Font Awesome placeholder and not-found icons, an inline SVG hero in Bulma colors, and Bulma's own dark mode.

Diff Markdown GitHub
14 20 6 25.4 17 Changed: Mocks

Replaces the six unlabeled screenshots with seven captioned ones: Home, New List, validation states, login modal, My Lists, published list and its QR code.

Diff Markdown GitHub
15 5 1 25.5 18 Added: Finally

Adds a Finally section asking the agent to open the finished site in a browser for the user to evaluate.

Diff Markdown GitHub
16 1 5 25.4 17 Removed: Finally on the sample page

Removes the Finally section added in revision 15, restoring the text of revision 14.

Diff Markdown GitHub

When a revision flips the line endings (CRLF ↔ LF), GitHub counts every line as changed, so + and − overstate the edit.

The habits behind these revisions are in the guide; the result is the sample PRD.