- 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
11 KiB
/team coverage (MASTER.md part 2, the 18 parts)
Page file: components/pages/TeamPage.jsx (+ TeamPage.css) · gallery: docs/gallery/team/ · metric id: signup_start (cta_click team.hero)
Open copy questions for James: the aria strings Pause and Replay (canvas control) wait for approval in content/ui-strings.json.
Shared changes requested (docs/build-notes/requests/team.md): none. Note for the conductor: taste.py --fix rewrote Hanzo's "PR #418" to "PR #262626" and the diff sample's colours on this page (restored here; copy outranks palette). It hits any "#" plus 3 or 6 hex-like characters, including /chrome.
Forks this page deleted: the forked Btn buttons (now the kit's Cta); the company PinScenes (replaced by page-local chapters whose headline clears first); the placeholder grey rooms.
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 Hanzo's copy (
lib/cta.jsdoes not exist yet) - One h1; the page is clear in 5 seconds
- No dead or self-looping button;
pricesn/a: no prices - Open copy questions for James listed, none decided
Done here: "Create your team" (hanzo.team/start) is the solid in the hero and the close. "Open Hanzo Team", "hanzoai" and "Deploy to Cloud" are quiet Ctas. The site's ask bar carries "Create your team" after the hero.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it - Every link through
A,Go,Moreorhref(); every card a real link Breadcrumbn/a: depth 1- Link parity: 0 removed, 0 unexpected
Done here: The layout's skip link reaches #main. The links are Cta, Lk (the kit's A) and the social icons. Parity is 20/20 links, and "Open Hanzo Team" now follows "in your workspace:".
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input
not merged in the kit yet; the hero is page-local and nothing sits above the h1PageHero- JS off: legible; no
opacity:0on the LCP element - One idea per 100svh; no 3 same-height sections in a row
- Ends in the Sigil close and footer
Morphn/a: no card opens into a page
Done here:
- The right column's fade and the board story both wait for
useArrived, so the first walk happens where people can see it. After the last card the cursor breathes, with Pause and Replay; a click on any card sends the cursor there. - The hero window is Hanzo's tracker board as live shows it (9 Nov): hanzo.team with Tracker Board / 23 AI Teammates / Virtual Office and 83% To do, four columns (BACKLOG – 7, TO DO – 6, IN PROGRESS – 3, DONE – 3) with live's eight CRM cards, and the phone strip (9:41, iPhone · hanzo.team Mobile, Web + Mobile synced, #hanzo-rev · Rev). One agent cursor walks the cards, each card's progress counts up to Hanzo's figure as its owner takes it, and every landing syncs to the phone strip. Live dropped the DMs, Rev's thread and the sleeping computer, so they are gone here too. On phones the board scrolls sideways inside the window and follows the cursor.
- With JS off the lede, asks, docs link and whole canvas show; the cursors are hidden and the chapters stack.
- Narrative: canvas hero, three pinned chapters, together, the rooms (miniatures), the dark workflow room, the code window, leaders, the spec, the close.
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
data-ctaanddata-thumbon every primary
Done here: Cta id="team.hero" thumb and team.close, plus team.hero-open, team.source and team.deploy. The "Paste and ship" prompt copies the exact displayed text.
5. Trust and proof
- No logo without permission; no seal; no invented number
- Every figure traces to Hanzo's copy
Marqueesn/a: nonePrivacy linkn/a: no form
Done here: 42/42, PR #418, (+18 -4), (+14 -3) and 8.9:1 all trace to content/live/team.json. The two PR numbers corrupted by the palette pass are restored.
6. Content presentation (copy untouched)
- No text under 13px (14px phone) except mono capitals
- Measures held; no orphan word in a heading
- Tabs use the APG pattern (arrow keys,
aria-selected) python3 scripts/parity.py /team: 0 missing
Done here: Parity is 242/242 text and 20/20 links. The invented "CHANNEL" label is gone, and Engineering · Security · … · Growth reads as Hanzo's line of text again.
7. Visual design system
python3 scripts/taste.py <files>passes; no literal hex outside the deck ramp- No label, tag, badge or pill above a headline
- Radii 24/16/12/8/6, art 20; windows outlined only, tiles flat; never box plus shadow
- One icon set; no icon in a rounded box
- Differs from neighbours in hero medium (a working multiplayer canvas)
Done here:
taste.pypasses (2 checked).TeamPage.cssuses only #0a0a0a, #171717, #262626, #525252, #737373, #a3a3a3, #d4d4d4, #e5e5e5, #ededed, #f2f2f2, #f5f5f5, #fafafa and #fff.- Headings come from
company/deck.css(weight 497). The hero canvas and code window are outlined with a 1px hairline and have no shadow.
8. UI component library
- Every control has hover, press, focus-visible, disabled, loading
- Focus ring visible on every stop of a Tab crawl
Dialogsn/aInputsn/a; no bare:hover- Forks this page deleted: listed above
Done here: The Pause/Replay control has a 44px hit area and presses at .97. The workflow and step tabs are APG tab lists. The inactive channel panels are inert and aria-hidden.
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 Soundthe shared sound kit is not in yet
Done here:
- Kinds of motion:
- Idle: the canvas story, then the breathing rest; the ten channels drifting under "One workspace"; the #bugfix chapter's reply being typed; the call faces taking turns speaking; the leaders' portraits breathing.
- State: tabs, steps, Pause and Replay.
- Pointer: the handoff faces drawing together; on a desktop the six handoffs share one stage beside the heading, the row at mid-screen (or under the pointer, or tapped) taking it, so one comes in as one goes out; arrow links step 3px.
- Arrival: the line masks, and the room miniatures making one move each (the board card sliding to Done, the calendar block filling).
- Scroll (2 of 6): the tilt-and-settle and the chapters.
- There are no springs: cursors and the card move at 0.9 s and 0.5 s ease-in-out. Reduced motion shows the final picture, with the stage untransformed.
10. Media
n/a: no film; memoji are CSS backgrounds over sized discsFilmVideosn/a- Every face has a fallback (the person's own initial: Z, D, Q…)
- No dimmed or filtered photo
Done here: Memoji failures leave a grey disc with the person's initial, from the INI map (Zoe = Z, Qa = Q). Leaders' portraits keep their initial plates.
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:
- On the phone the board's rows are fixed at 128px and the task joins a row after its cards (order), so nothing moves; the workflow room walks itself only on a desktop (on a phone a tap changes it), so CLS walked is 0.000 at 375 and 0.001 at 1470.
- The chapters stack with their visuals and the giant numerals are hidden. The workflow rail is a swipe row of 44px pills.
- Arrow links, "Open →", "Open Hanzo Team" and Pause/Replay are 44px. The window dots are
flex:none.
12. Accessibility (WCAG 2.2 AA)
- Contrast measured, text at 4.5:1 or better
- Pause control on every moving item (the canvas)
Formsn/a- One h1; no heading skips; names start with visible text
- Keyboard reaches every control
Done here: The canvas is aria-hidden decoration beside real text. Focus inside a chapter scrolls the page to it. Tabs move with the arrow keys.
13. Performance and engineering
- h1 and LCP element in server HTML
- Transform and opacity only
- No poller; no third-party request
- Nothing heavy run on James's laptop
Done here: Layout shift walked 0.000 (375) and 0.001 (1470): no fr animation, the phone room changes only on a tap. The canvas runs only while seen. The stage's transform is the same on server and client (no reduced-motion branch in JS; CSS removes it), so there is no hydration error (console clean).
14. SEO and machine files
- Title and description match live
- Canonical belongs to the shared layout owner
<JsonLd route="/team">unchangedCardsn/a: no linking cards
Done here: app/team/page.jsx keeps Hanzo's title and description.
15. Catalogue and product pages
Model cardn/a: not a catalogue or model page
Done here: n/a. As a Launch page it has the hero product, the show-it canvas, chapters, the spec (License: MIT, source, deploy, paste-and-ship) and one closing ask.
16. Developer experience
- The paste-and-ship prompt copies exactly the displayed text
Config blocksn/aTerminaln/a: the code session is stepped by hand- No hand-typed version number
Done here: The diff sample is Hanzo's own code text, kept byte-identical (written so the colour checker skips it).
17. States and resilience
- Static content; no loading state needed
- Blocked media leaves a complete page, no console errors
Failed submitn/a- A thrown island does not blank the page
Done here: With hanzo.ai blocked (cloud), the memoji fall back to initial discs. The console is clean.
18. Measurement and handover
data-ctaon every primary (throughCta)- Nothing identifier-bearing before consent
V2: 8/10 …in the page file's top comment- Review read:
docs/build-notes/review/team.mdwas 6/10; every listed fix is done, awaiting re-review
Done here: The re-review (7/10) fixes are in. #bugfix stays the one open case and the other nine channels are sized to their content (on the phone a tap shows only that channel; with JS off all ten read as a list). The canvas starts on its first frame and rests its cursors above the fold. On the phone: 28px under the Code and Leaders headlines, cursor labels clamped inside the board, and board rows of fixed height (no column snapping). The gallery was not re-filmed after these fixes (stopped for usage).