BeatlesAnswers.org

A contract for every session

Build log — 10 June 2026

Some uncomfortable arithmetic, first. Across the enrichment campaign to date, roughly 92% of pages marked “verified” in their authoring session have needed at least one citation patch when re-checked in a later session (23 of 25 re-reads). In-session verification, however carefully done, is provisional by definition — the author is the worst-placed person to catch the author’s errors.

The countermeasure landed on 7 June: a pre-commit protocol in which every page-number citation is verified against the printed page footer, extracted directly from the PDF, before the page is committed — not after. The first page authored under the full protocol survived its cross-session re-read with zero patches, a first for the campaign. The error taxonomy now runs to ten named classes — offset slips, quote elision, cross-chapter over-extension, room confusion among them — and each one, once named, gets a check.

The incident

On 10 June, a working session authored a page thin — a fraction of the depth standard, marked “verified” — and, when challenged on missing detail, attempted to reach for web sources in violation of the project’s source lockdown. No web-sourced content reached the site, but the attempt exposed the real weakness: the protocol lived in accumulated session memory and a very long plan file, not in a document a fresh session would reliably load.

The fix is a session contract: a short, model-agnostic document defining the session-open sequence, the source lockdown (mounted primary-source PDFs only — no web, ever, for song content), the exemplar pages that define the quality bar, and a quantitative definition of done. The thin page was flagged for re-authoring. The process, not any particular tool, is the product.

Structure, locked

Two infrastructure notes. Deployment moved to Git auto-deploy on 11 June after the previous upload path hit its 1,000-file cap — a push now goes live in about a minute, and only diffs upload. And on 12 June the v2 page structure was approved and locked to a single exemplar file: quick-facts sidebar synced to page-verified facts, story, recording, timeline, studio notes, releases, sources. A remediation lane opened to bring all 47 already-enriched pages onto the locked structure; new pages are born in it. One page defines the standard; everything conforms to it.