- README.md: what this is, how to run and build it, the folder map, how light and dark mode work (@hanzo/appearance, @hanzo/design), where every price and checkout link lives, scripts, and known differences from live - docs/build-notes/: status files, request notes, per-page checklists and reviews, plans - Removed: screenshot galleries, captures of third-party sites used as references, the generated status page and its script, editor config, a personal working-rules file - Code comments point at the new docs paths (no code changes) Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01P5YBdwj33XByFVTvu9bfci
12 KiB
/kata coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/Kata.jsx (+ .css) · gallery: docs/gallery/kata/ · metric id: cta_click kata.hero
Open copy questions for James: none.
Shared changes requested (docs/build-notes/requests/kata.md): UI strings (A Kata session, Test runner, CI, Language, The suite turns) as accessible names only; data-cta on the kit Band; the desktop ask bar floating over content; the Terminal and PageHero kit parts.
Forks this page deleted: the hand-written hero and close buttons (now kit Cta and Band), the custom closing section, the capabilities report bar and PASS chips, the invented stack-check title, labels and answer sentence, the green wipe and every green, the 108px and 320px type, springs.
Tick what applies. Strike the rest as n/a: reason. Fill each Done here: line with one or two sentences of evidence (a value, a file, a number). A part counts once its Done here: line has text.
1. Strategy and conversion
- Header comment has Persona, Goal, CTA, metric id, Signature, Beyond
- One solid fill per viewport; label and href from
lib/cta.js - One h1; the page is clear in 5 seconds
No dead or self-looping button; prices fromn/a: no prices on this pagelib/plans.js- Open copy questions for James listed, none decided
Done here: Header lines Persona/Goal/CTA/Metric/Signature/Beyond in Kata.jsx; one solid at a time: kit Cta "Get API key" (kata.hero, thumb) in the hero, repeated in the kit Band; usePhoneAsk outlines the header ask while either is on screen, and its arrival rule starts the header as an outline on .xkt, so one solid shows from the first frame. Round 9 (8 Nov) measured it at 1470 and 375: on arrival and at 1200 ms only the hero's "Get API key" is solid; at the Band only the Band's is (the page marks the kit Band's button data-cta="kata.band" and sends the same cta_click, so the hook sees it). lib/cta.js does not exist yet; the label and href are Hanzo's own from the page.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it - Every link through
A,Go,Moreorhref(); every card a real link Breadcrumb at depth 2 or moren/a: depth 1- Link parity: 0 removed, 0 unexpected
Done here: One
inside the layout's #main marker and skip link; links via kit A and Cta; site pages in the link cards carry data-morph; parity links 11/11; depth 1.3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
PageHero; nothing above the h1- JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; no 3 same-height sections in a row
- Ends in proof strip,
Band, footer - Card-to-page links use Morph; title lands within 12px
Done here: h1 "Test. Repair. Verify." at 52px cuts in by a CSS line mask from the first paint (700 ms, 60 ms apart; nothing absent before hydration) and lights word by word with the live session; round 9: the server paints step 0 of the loop, so the first frame seen is the loop's first frame (no finished session then a wipe), and the hero object rises 24px without fading; it moves within 1 s (alive check: moving at 1470x801 and 375x812). JS off: 0 hidden text (4 dial number buttons hidden on purpose). Ends: questions, kit Band, footer.
4. Conversion system
<Cta>only; no raw.x-btn- Sticky ask in header and bar after the hero, same label
- Copy button copies exactly the displayed text; failure never says Copied
data-ctaanddata-thumbon every primary
Done here: Kit Cta only (solid hero, quiet GitHub, plain docs link); the header carries "Get API key" after the hero on desktop; on phone the header keeps "Try Hanzo" (outlined while a page ask is on screen): the shared usePhoneAsk keeps Hanzo's label when the swapped one would not fit, so the phone half of this box stays open (request in docs/build-notes/requests/kata.md); the A2Paste strip copies exactly the prompt it shows.
5. Trust and proof
- No logo without documented permission; no seal; no invented number
- Every figure traces to Hanzo's copy; qualifier beside the number
Marquees pause, freeze under reduced motion, hide duplicatesn/a: no marqueePrivacy link and owner line beside every submitn/a: no form sends anything (the stack check is local)
Done here: No logos, seals or invented figures: 12 passed · 1 failed and 13 passed · 0 failed are Hanzo's session text; the stack check answers only with Hanzo's own sentences.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals
- Measures held; no orphan word in a heading
- Tables, FAQ, tabs and code use the kit parts
python3 scripts/parity.py /kata: 0 missing
Done here: Deck sizes: h1 52, section headings 26, H3 17, lede 21, body 16, figures 44 in the board and 64 at rest in the dial and room; 13px floor (mono render text 13-14px). Parity 76/76 text, 11/11 links. FAQ through A2Faq; the terminal is page-owned until the kit Terminal lands.
7. Visual design system
python3 scripts/taste.py <files>passes; no literal hex outside tokens- No label, tag, badge or pill above a headline
- Radii, shadows and sizes from tokens; never box plus shadow
- One icon set; no icon in a rounded box
- Differs from neighbours in hero medium and room order
Done here: taste.py passes (deck greys only, no green); brows check 0 labels above a headline; tiles 24, cards 16, no shadows; failing shown by an outline dot and a strike, not a hue. Round 9: the Read section is one ruled list of 9 rows (group as a 12px mono caption, no boxes), so there are no three equal boxes. Literal greys in Kata.css still to move onto tokens.
8. UI component library
- Every control has hover, press, focus-visible, disabled, loading
- Focus ring visible on every stop of a Tab crawl
Dialogs are native, trap focus and return itn/a: no dialog on this page- Inputs 16px or larger; no bare
:hover - Forks this page deleted: the hand-written hero and close buttons (now kit Cta and Band), the custom closing section, the capabilities report bar and PASS chips, the invented stack-check title, labels and answer sentence, the green wipe and every green, the 108px and 320px type, springs. listed below
Done here: Chips, Replay and links press to .97 or 1px; focus ring from the system and on Replay; hovers only inside (hover: hover); no inputs. Round 9 hovers (measured): Read rows fill #f5f5f5 and show where they go; the dial's chapter index inks its number and darkens its bar; the questions underline their words and slide the plus 4px.
9. Motion and interaction
- One signature, at most 3 supporting techniques, at most 2 fade-ups
- At least 3 kinds of movement; scroll-linked is half or less
- Something moves without input; every control answers
- Reduced motion shows the final state; no
setInterval - Sound only on the listed moments, through the one kit
Done here: Signature: the loop headline lit by the live session (time); supporting: pinned dial chapters (state), the room's scrubbed wipe and growing figure (scroll), drawn ticks (arrival); round 9 idle (time, CSS): the board's dots breathe while the suite runs, the failing one rings, the passing row sends a slow wave, the dial's current station rings, the pinned room's command keeps a caret, and the stack check tries itself one group at a time until your first pick (sentences not announced until then). motion.mjs desk: 0 still screens (8 before), CLS 0.004. variety.py OK; reduced motion shows the passing state with 0 running animations and 0 console errors (the page's own Lines and Room replace the shared A2Lines and A2Room, whose render branch failed hydration under reduced motion); timeouts only, no setInterval.
10. Media
n/a: no images or films: the board, terminal, dial and room are drawn in the DOMFilmandPiconly; sizes and posters setAt most 2 videos playing; pause button on loops over 5 sn/a: no videoBudgets met; nothing missing; alt on every imagen/a: no imagesNo dimmed or filtered photo; 4+ real visuals together where the page has themn/a: Hanzo has no Kata media
Done here: No media on this page; every visual is drawn in the DOM with Hanzo's real session text.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll at 320
- Every target 44px or more; every hover has a tap path
- Primary ask above the fold at 375×667
Done here: 375x812 and 1470x801: 0 text overlaps (round 9: the dial's dots sit on the ring with their labels inside it, 18px clear; check.mjs phone OK, desk only flags the wipe's two stacked layers, which is the clip by design); phone first screen shows 88px of the board inside 375x660 (board top at 572: hero padding 80, grid gap 20, docs link hidden on phone, it repeats the Read list); on desktop the capabilities rise over the empty lower third of the pinned wipe, so no void after "0 failed"; 320 scrollWidth 320; ask bottom at 524px on 375x667; chips, Replay and links 44px or more on phones.
12. Accessibility (WCAG 2.2 AA)
- Contrast measured, text at 4.5:1 or better
- Pause control on every moving item
- Forms labelled; first error focused
- One h1; no heading skips; names start with visible text
- Keyboard reaches every control
Done here: Text #0a0a0a/#525252/#737373 (unlit h1 words and the idle file name, 4.74:1) on white and #a3a3a3 or lighter on black; pause control first in the hero box (stops the loop and the cursor); radio groups named; one h1, h2 sections, h3 items; keyboard reaches every control.
13. Performance and engineering
- h1 and LCP element in server HTML
- JS and CSS inside budget; every image and video sized
- No poller; no third-party request before consent
- Nothing heavy run on James's laptop
Done here: h1 and the hero object are in server HTML (the loop's first step; JS off shows the whole session by CSS, 0 hidden text blocks at 1470 and 375); transform, opacity and clip-path only; the loop stops off screen and when paused; budgets not yet measured.
14. SEO and machine files
- Title and description match live (or are listed for James)
- Canonical equals og:url equals the live URL
<JsonLd route>parses; no broken URL- Every card is a real link
Done here: app/kata metadata unchanged from content/pages.json; JsonLd route=/kata; every card row is a real link.
15. Catalogue and product pages
Model card matchesn/a: not a catalogue or model pageSPEC.md(or n/a: not a catalogue or model page)- Every card opens by Morph
Every maker and model page linked in the DOMn/a: not a catalogueOne price figure everywheren/a: no prices
Done here: Not a catalogue; site links in the read cards open by Morph.
16. Developer experience
- One
CodeBlock; copy equals display (or n/a: no code on the page) Config blocks parse on their ownn/a: no config block on this page- Terminal pauses and ends on a static frame
- No hand-typed version number
Done here: The terminal replays Hanzo's session and ends on its full static frame with a pause control; no version numbers. Page-owned until the kit Terminal lands.
17. States and resilience
- Loading, empty, error and offline states designed
- Blocked live data leaves a complete page, no console errors
A failed submit keeps its values and shows no successn/a: no submit- A thrown island does not blank the page
Done here: No live data, so nothing can fail or load; the stack check has an empty state (Hanzo's sentence in grey until you pick).
18. Measurement and handover
data-ctaon every primary; events only throughlib/track.js- Nothing identifier-bearing before consent; no field value in a payload
V2: <score>/10 <one line>in the page file's top comment- Review read:
docs/build-notes/review/kata.mdverdict 8 or more
Done here: data-cta on kata.hero; the kit Band's button is marked kata.band by the page (useBandAsk) and sends cta_click until the kit does it (requested); Cta sends cta_click through the system event; V2 line in the header; reviews read: 6/10, then 7/10 (7 Nov); round 9 (8 Nov) answers the 7/10: unlit words #737373, phone board in the first screen, arrival without the reset, one solid at a time, dial labels clear, one ruled Read list, no voids, a terminal beside the questions.