Cut non-essential prose from docs and comments, and require the same of every future change #63
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: larvit/plainpages#63
Reference in New Issue
Block a user
Delete Branch "prose-diet"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
README 2000 → 1516 lines, AGENTS.md keeps its decisions but loses the narrative, todo.md 74 → 69 with the completed-item essays collapsed to task lines, and ~170 comment lines gone. Everything cut is history, restatement, or a fact already stated elsewhere.
New in AGENTS.md: a Prose discipline section making this a standing pass on every change — delete history, delete restatement, one home per fact, give every accepted risk an expiry.
src/compose.test.tsexpects 6 documented E2E run commands instead of 10, since README now states the command once and lists the suites in a table.Typecheck and the 468 unit tests pass locally.
README loses the competitor comparison, the personas and the repeated philosophy; the five near-identical E2E command blocks become a table plus one command, and the file map a clause per entry. AGENTS.md keeps every decision but drops the narrative around them. todo.md's completed items collapse to their task line — git holds the rest. Comments lose restatement, README duplication and history ("used to", "originally", dated notes). AGENTS.md gains a Prose discipline section making this a standing pass on every change rather than a one-off cleanup. src/compose.test.ts now expects 6 documented E2E run commands, not 10, since the README states the command once instead of per suite.