[ancsingabor]

Eight six-row tables were doing the work of eight paragraphs. Each story is now prose in three beats — what happened · why nothing caught it · what changed — ending in the commit hash. 2,343 → 1,734 words.

Two defects that had to be fixed first

• Stories 6, 7 and 8 said Commit | this PR — a placeholder that went stale on merge, in exactly the three stories with no ADR behind them. So the page was their only readable record, and there was nothing to link down to. All three are f5c8363, on main, whose commit message is the long version. That makes "git show any hash above" true for all eight — which is what licenses this page to be a summary rather than the record.
• The chapter had no "Where this lives in code" section, which the shape rule requires and docs:lint does not check. Added, with the four files the stories bought.

Also dropped the per-story "the general form is…" paragraphs, which restated what § The pattern already tabulates one row per story, and the Symptom | None. rows, since the TL;DR already says none of these crashed.

The line budget was measuring the wrong thing

Lines have now given the wrong answer twice, in opposite directions:

	verdict	reality
Chapter 03, counting fenced blocks	200 lines, too long	68 lines were Mermaid; the real fault was two jobs on one page
Chapter 10, excluding them	183 lines, fine	the longest page in the guide by 65%

Chapter 10's content sat in table cells at ~13 words a line where prose runs ~9, so the budget never saw it. This rewrite cut 500 words and added 30 lines — a measure that moves the wrong way under a real improvement is the wrong measure.

≤ ~150 lines → ≤ ~1,400 words, measured wc -w. Every other chapter already passes:

01 1006   02 1117   03 1118   04 1418   05  922   06 1364
07 1283   08 1225   09 1382   11 1081   code-map 1051

Chapter 10 is the stated exception and is budgeted per item instead, because it is a collection whose unit is the story: ~150 words a story plus the shared sections. A ninth story buys 150 words, not an open page — and the split seam is named in case it outgrows that (corpus bugs that shipped, 1–5, against measurement bugs a refusal caught, 6–8).

All seven hashes verified to resolve on main. docs:lint green.

🤖 Generated with Claude Code