Files
Claude 07cf81bd47 Handoff layout: new README; build-chat notes moved to docs/build-notes/
- 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
2026-11-08 13:22:36 +00:00

13 KiB
Raw Permalink Blame History

/insights coverage (MASTER.md part 2, the 18 parts)

Page file: components/pages/cloud/Insights.jsx · gallery: docs/gallery/insights/ · metric id: cta_click insights.hero

Open copy questions for James: none. Shared changes requested (docs/build-notes/requests/insights.md): the solid-button hover token, the kit CodeBlock greys and the .v2-dark text colour onto the deck ramp (done page-locally meanwhile), and the phone header ask label. Still waiting on tokens.css, lib/cta.js, lib/track.js, PageHero, and the kit Tabs swap to land on main. Forks this page deleted: the page's own hero shell (Frame Hero), hand-made buttons (.v2-btn became the kit Cta), a second ending (the agent prompt moved mid-page), the sticky phone visual over text (chapters now stack), every spring transition, the invented rollout percentages, the Frame code pane (now the kit CodeBlock), Frame useEvery. Round 2 removed the invented strings: the ten "Ask it a question" questions, the trimmed answer sentences, and the made-up event names in the drawings ($autocapture, $pageview, signup_completed, TypeError: …, select … from events, kill switch · no deploy). Each was checked against content/live/insights.json, content/pages and content/ui-strings.json first and was in none of them.

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 are Hanzo's hero ask (lib/cta.js is not on main yet)
  • One h1; the page is clear in 5 seconds
  • No dead or self-looping button; no prices on this page
  • Open copy questions for James listed, none decided

Done here: // Persona: to // Beyond: head components/pages/cloud/Insights.jsx; the one ask is Hanzo's "Open Insights" (insights.hero, insights.close). Measured with a headless walk: one solid button on the first screen at 1470×801 and 375×812.

2. Information architecture and navigation

  • One <main>; the layout's skip link reaches #main
  • Every link through A or the kit Cta; related cards are real links
  • Breadcrumb at depth 2 or more n/a: a depth-1 page
  • Link parity: 0 removed, 0 unexpected

Done here: Parity 67/67 text and 4/4 links; Hanzo's header and footer are untouched; every link goes through A/Cta (lib/route.js). Rounds 3-4: the separate finder block is gone; its ten tool names are the tour panels' own sub-nav, so the page draws each view once.

3. First impression and page narrative

  • Sells in 5 s; something moves within 1 s without input
  • Hero built from the kit's line mask (Lines) and one object (PageHero is not on main yet); nothing above the h1
  • JS off: legible; no opacity:0 on the LCP element
  • One idea per 100svh; loud and quiet sections alternate
  • Ends in one close in Hanzo's words ("Get Insights" with the ask), then the footer
  • The h1 is the data-morph-target, so cards elsewhere open into it

Done here: The first screen is the name, Hanzo's line, the ask, and one live object: the new-dashboard flag rolled out to a percentage, then a cohort, then one account across a field of 120 people (20×6 on desktop, 12×10 on phone) who light up and send events, until the kill switch turns it off with no deploy. Measured at 1470×801 in round 2: the h1 is top-aligned with its bottom at 302px (38% of 801), the object runs from 100 to 595 so it ends inside the first screen, and "Ship it, then find out" peeks at 735. The h1 (52px, 40px on phones) cuts in by CSS line mask at first paint; a headless JS-off pass found 0 hidden text blocks. Rounds 3-4: the hero field lights in its stagger at 150 ms and the first event lands at 300 ms; "one account" grows to one big dot (scale 2.6), the page's one scale moment; the dark room sits on the section token (clamp 72-188px), no empty black above and below the code.

4. Conversion system

  • <Cta> only; no raw .x-btn in the page
  • Sticky ask: the shared ask bar carries the hero label (data-thumb)
  • Copy buttons copy exactly the displayed text (kit CodeBlock/Copy)
  • data-cta and data-thumb on every primary

Done here: Hero <Cta thumb id="insights.hero">Open Insights</Cta>; the close repeats it (insights.close); Hanzo's other buttons are quiet or link Ctas.

5. Trust and proof

  • No logo, seal or invented number
  • Every figure traces to Hanzo's copy
  • Marquees pause, freeze, hide duplicates n/a: no marquee
  • Privacy link beside every submit n/a: no form submits

Done here: The only figures are Hanzo's own (none; the rollout shows Hanzo's three ways in words, never a percentage); demos use Hanzo's words, never invented numbers.

6. Content presentation (copy untouched)

  • No text under 13px (14px on phones) except 11–12px mono capitals and the kit's own copy label
  • Measures held; headings balanced
  • Code uses the kit CodeBlock; tabs are the page's own APG-style tablist (kit Tabs swap listed below)
  • python3 scripts/parity.py /insights: 0 missing

Done here: Parity 67/67 text and 4/4 links. The tool finder uses only Hanzo's tool names and shows each one's whole sentence (its own clause in ink), never a cut. Section heads rest at 26px, the Events/Flags/OSS figures are 21px Zen Mono, and the tool name and "Start with autocapture" are 32px. Phone labels are 14px (components/pages/cloud/Insights.css).

7. Visual design system

  • python3 scripts/taste.py passes (deck greys only; no hue)
  • No label, tag, badge or pill above a headline
  • Radii 28 (objects), 16–24 (tiles); one shadow per raised object
  • One icon set n/a: no icons beyond the kit's
  • Differs from neighbours in hero medium and room order

Done here: Greys from Hanzo's deck only: the page defines the deck ramp once as tokens on .in and every rule uses them. The Apple greys (#fbfbfd, #e3e3e6, #f5f5f7, #161617, #1d1d1f, #f2f2f5), the dot glow and the "Accent: violet" note are gone. A computed-colour sweep of <main> finds no grey off the ramp; the kit's CodeBlock and the button hover are mapped page-locally and requested. One dark room (the code and the app it flips). Rounds 3-4: one surface in the hero card (no inner white cards), the tour window is outlined, not raised, the selected tab is marked by its ink underline (no lift shadow), radii on deck values.

8. UI component library

  • Every control has hover (inside @media (hover:hover)), press .97, focus-visible, disabled
  • Focus ring is the shared system's
  • Dialogs are native, trap focus and return it n/a: no dialog on this page
  • Inputs 16px or larger; no bare :hover in the page CSS
  • Forks this page deleted: listed above

Done here: Kit Cta, CodeBlock, Copy and Cloud 3's LivePause. Hovers tell you something: hovering a rollout mode lights a ghost of the dots it would reach (29 for "a cohort") without committing; the kill switch's knob leans 3px toward the other state and the track darkens, with a .97 press; a tour tab's number steps to ink and a hairline draws under its title. Round 4: a pointer resting on the tour window holds the tab (so its words can be read) while the panel's own views keep cycling every 2.6 s, and a pointer on the tool names holds the view; tour tabs preview their panel on hover and tick; the mode labels invert as the pill passes (mix-blend difference).

9. Motion and interaction

  • One signature, at most 3 supporting techniques, at most 2 fade-ups (variety.py OK)
  • 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 in the page (timers are setTimeout chains)
  • Sound only on the listed moments, through the one kit (lib/sound.js, wired by components/Sound.jsx): the ask taps, tabs, radios and pause toggles tick (radios carry data-sound="tick"), copy chimes; the demos loop while seen and never finish, so no done chime

Done here: Signature: a flag you roll out by hand. Idle: the rollout steps through its three ways and the kill switch; the window tours its tabs; the app flips with the flag. State: rollout radios and the kill switch; the tab pill glides; the finder's drawing and sentence swap per tool. Round 2 kept every move and added the mode-hover ghost. Scroll: none beyond the headline cut-in. No springs: every move is ease-emphasis at 300 ms. Rounds 3-4: each panel is a product view built from page words (event stream and SQL, flag rows and kill switch, a replay whose cursor travels its path, a heatmap, an experiment wired flag-to-metric with A/B bars, funnel / retention / paths, a rage-click spike over a stack trace, an LLM cost waterfall), each drawing itself in when its tab opens.

10. Media

  • Film and Pic only n/a: no photo or film on Hanzo's page
  • At most 2 videos; pause on loops n/a: no video
  • Nothing missing; no image without alt
  • No dimmed photo; 4+ real visuals together n/a: Hanzo's page has no imagery

Done here: Product objects are drawn in HTML and CSS from Hanzo's words. The close carries the product's own Sigil over a field of dots, the hero's people, so it is not the shared contour close. CLS measured with a 30 s idle and a full scroll: 0.0004 at 1470×801 (all from the shared header) and 0.0000 at 375×812. Before round 2 it was 0.158 and 0.088.

11. Mobile and responsive

  • 375×812 and 1470×801 pass with no overlap
  • No horizontal scroll at 320 (scrollWidth 320)
  • Every target 44px or more; every hover has a tap path
  • Primary ask above the fold at 375×667

Done here: At 375 the name, line and ask come first, then the rollout. The window's tabs become a swipe row, and the six panels share one grid cell, so the window holds at 736px while it tours (it used to swing between 651 and 761). The finder's ten tools become a proximity snap rail with a peek, with the answer directly under it. The code and the app stack. Nothing floats over text. Round 4: check.mjs at 375 and 1470: errors 0, covered 0, wide 0; the phone tab rail keeps the active tab fully in view as the tour moves; "Deploy to Cloud" measured 44px tall at 375.

12. Accessibility (WCAG 2.2 AA)

  • Contrast: #0a0a0a and #525252 on white and #f5f5f5, #a3a3a3 and white on black
  • Pause control (Cloud 3's LivePause, 44px, aria-pressed) on every self-running object
  • Forms labelled (no form fields)
  • One h1; no heading skips
  • Keyboard reaches every control

Done here: The live object is aria-hidden with its pause button outside it; tabs and radios carry aria-selected/aria-checked; aria-live where a demo answers.

13. Performance and engineering

  • h1 and the hero object are in the server HTML
  • Transform, opacity and clip-path only; demo timers run only while on screen
  • No poller; no third-party request
  • Nothing heavy run on James's laptop (filmed in the cloud)

Done here: Timers stop off screen and when paused (useLive and useTick); bundle size not measured on this page.

14. SEO and machine files

  • Title and description from content/pages.json
  • Canonical through the shared <JsonLd route="/insights" />
  • <JsonLd route> renders; no broken URL
  • Every card is a real link

Done here: app/insights/page.jsx unchanged: metadata from content/pages.json and <JsonLd route="/insights" />.

15. Catalogue and product pages

  • Model card matches SPEC.md n/a: not a catalogue or model page
  • Every card opens by Morph n/a: no catalogue cards
  • Every maker and model page linked n/a: not /models
  • One price figure everywhere n/a: no prices

Done here: n/a: a top-level cloud product launch page; its h1 is the data-morph-target for cards that open into it.

16. Developer experience

  • One CodeBlock; copy equals display
  • Config blocks parse on their own n/a: no config block
  • Terminal pauses and ends on a static frame n/a: no typed terminal
  • No hand-typed version number

Done here: Hanzo's agent prompt and the app.tsx sample use the kit CodeBlock, whose Copy copies exactly what is shown.

17. States and resilience

  • Every state looks intended: static copy, reduced motion and JS off checked
  • No live data, so nothing to block; no console errors
  • A failed submit keeps its values n/a: n/a: no form posts anywhere; the page's inputs are in-page demos and nothing is sent
  • A thrown island leaves the page: the shared app/error.jsx keeps header and footer

Done here: A headless JS-off pass shows every word; reduced motion stops each demo on its final frame.

18. Measurement and handover

  • data-cta on every primary (the kit Cta sends cta_click); lib/track.js is not on main yet
  • Nothing identifier-bearing; no field value in any payload
  • V2: 8/10 line in the page file's top comment
  • Review read: docs/build-notes/review/insights.md (6/10); fixes 1 to 8 done in round 2, and fix 9 (shared header) is requested

Done here: insights.hero and insights.close on the asks. Gallery: docs/gallery/insights/ (desktop film, phone stills, and round 2 frames round2-desktop.jpg, round2-phone.jpg and round2-finder.jpg). Round 4: review round 2 (7/10) fixes 1 to 7 and 9 done (rounds 3 and 4); 8 is shared chrome, filed in docs/build-notes/requests/insights.md. Proof docs/gallery/insights/round4-*.jpg.