toolkit

Scenario · The bigger jobs

Five-lens review of a client deliverable

A finished deliverable — a report, a deck, a proposal — is about to ship and nobody has read it end to end yet.

One person reading a finished deliverable end to end before it ships catches whatever that one person happens to notice — a wrong number, an illegible chart on a phone, a document that never actually asks for anything — and no single read-through is tuned to catch all of those kinds of problems at once. This runs five separate, narrow passes, each looking for one specific kind of defect, and keeps their findings separate rather than blending them into one score, because a document can be completely right on four fronts and badly wrong on the fifth, and averaging that away hides exactly where the fix needs to start.

What to ask for

See it work

A real run of Accessibility (a11y):

Accessibility (a11y) · accessibility-a11y — https://toolkit-tests.pages.dev/a11y/missing-alt.html
  running axe-core (wcag2a, wcag2aa, wcag21a, wcag21aa) across desktop,iphone-17 …

FAIL — https://toolkit-tests.pages.dev/a11y/missing-alt.html
  1 critical  0 serious  0 moderate  0 minor  0 to review  20 passed
   critical image-alt (1 el, desktop/iphone-17)

  report: ./out/accessibility-a11y-accessibility-a11y.html
  json:   ./out/axe.json
  text:   ./out/accessibility-a11y-accessibility-a11y.txt

The captured report, exactly as a run hands it to a client —open the full report ↗

Seen in the wild

Four cards, one client, the same three defects on every target page.

Board6 · Ready to Add

Four procedure pages for one practice

Content Workflow 2.0

These four sit in the developer’s queue: approved content, waiting to be added to four named pages. The content has been checked. The pages it is going onto have not — so they were, before the work starts rather than after it lands.

What the four target pages returned

Pages checked4
Two <head> tags4 of 4
Title read fromthe body
Description read fromthe body
Canonical read fromthe body
Two <h1> tags4 of 4
Open Graph tagsnone, on any

Identical on all four, which is the tell: this is what that site builds, not what four separate people did to four separate pages.

What the new content lands on top of

  • Title and canonical sit in the bodyConfig
  • Two H1 tags on all four of themSearch
  • No social share tags on any pageSearch
  • Content is queued to land on topUnseen

The title, description and canonical are the three things a search engine reads first, and on all four pages they are sitting outside the first <head> — technically in the body. Search engines recover from this. What does not recover is any tool, plugin or tag manager that writes to the head and picks the empty one.

The contentWhat gets checked before it ships
The page tooChecked once, before the work starts

One review pass catches whatever that reviewer happens to notice. A wrong number, a proof panel that contradicts its own caption, illegible mobile figures, a duplicated claim, and a document with no closing ask are five different kinds of defect, and no single read-through is tuned to catch all five at once. Running five narrow passes, each with one job, catches what one broad pass misses.

  1. Treat this as a full pre-ship pass, not a fix-one-thing check. Running only the lens that seems relevant to today’s worry misses exactly the defects the other four exist to catch — that’s the whole reason there are five instead of one.
  2. [manual] Presenter lens. Read it as the person about to pitch it live: section-by-section momentum, whether the 90-second open actually lands, objection coverage against the talk track, whether the document lands an ask anywhere, and any single slide or section that would derail the room.
  3. [manual] Client-eye lens. Read it as a skeptical owner would, twice: the 3-minute skim path and the 30-minute full read. Where does trust get built, and where does it wobble; is it comprehensible without jargon; what does its tone say about whoever it’s implicitly being compared against.
  4. [manual] Story lens. Check the narrative spine on its own terms: one headline system carried through start to finish, no claim repeated verbatim across two sections in a way that reads as padding, and a real close — a document that asks for something rather than one that just stops.
  5. UX/data-viz lens, run against the rendered document. Capture it at three widths and every figure individually, grade contrast against WCAG, and check table layout at each width plus the print stylesheet. A proof panel that’s illegible on a phone, or unreadable once printed, is a defect regardless of whether the content behind it is correct.
  6. Data-QA lens, run against the claims register. Recompute every registered number from raw sources — never from the document — and diff the document’s claim wordings against the register; make-the-numbers-defensible is how that register gets built in the first place. A proof panel whose visible rows contradict the sentence it’s attached to is this lens’s finding, not the story lens’s.
  7. Collect every finding under one contract, and keep the five verdicts separate. CRITICAL / MAJOR / MINOR, its location, and the fix — reported per lens, not blended into one score. A document that fails only the data-QA lens and a document that fails only the UX lens need different people to fix them, and averaging the two into “REVIEW” loses that information.
  8. [manual] Apply every CRITICAL and MAJOR finding. Route anything that changes the actual pitch — dropping a section, changing the ask, reordering the narrative — to whoever owns the deliverable; that is a strategic call this review surfaces but cannot make on its own.
  9. Re-run the lenses a fix touched, not just a read-through. A contrast fix that turns out to fail on a different element, or a narrative edit that reintroduces a claim already used elsewhere, only shows up by checking again — not by trusting that the intended fix landed clean.

Five verdicts, not one

The value of running this as five lenses instead of one broad review is that a deliverable can be completely correct on four axes and fail hard on the fifth — every number right, contrast broken sitewide; or the narrative landing perfectly, one figure quietly contradicting its own caption. Blending that into a single pass/fail hides which axis actually needs the fix; keeping five verdicts tells whoever picks up the findings exactly where to start.

What this does not cover

Which finding matters most to this particular client, and whether the deliverable's ask is the right ask. Five lenses surface CRITICAL/MAJOR/MINOR defects against a shared contract; deciding which fixes are worth the time before a deadline, and whether the strategy behind the document is sound, stays with whoever owns it. It also does not replace `second-opinion-on-this-page`, which audits a live page — this reviews a finished document as an artefact, before or instead of anything being published.

← All scenarios