- 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
13 KiB
/philosophy coverage (MASTER.md part 2, the 18 parts)
9 Nov rebuild (slice D): Hanzo replaced the page's copy on live hanzo.ai (the five laws, premise, method, stack and questions are gone). The page was re-read from live and rebuilt on the same system: hero hexagram walk (now Hanzo's new 64), introduction, the explorer (category filter, 8 x 8 index, the chosen pattern's three applications), the eight categories (every row opens the sheet), the dark-room close. Parts below that name the removed sections describe the 7 Nov build; the parts themselves (ask, motion, states, reduced motion, JS off, entrances, proof) hold for the new one. copycheck vs live: missing 0 of 166; parity 386/386.
Page file: components/pages/Philosophy.jsx (+ Philosophy.css, data philosophy/patterns.js) · gallery: docs/gallery/philosophy/ · metric id: philosophy.close (cta_click), lead philosophy.hero
Open copy questions for James: none (no copy changed; "Philosophy", "The premise", "The synthesis", "The 64 patterns", "The method", "Across the stack" are Hanzo's labels, set as captions under their headings).
Shared changes requested (docs/build-notes/requests/philosophy.md): none.
Forks this page deleted: the floating AskBar pill (MASTER: nothing floats over content), the 236px headline (now 52px at rest), the v1 "seal" kickers above headings, the spring and overshoot easings, every hover lift and scale.
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 page ("Explore the 64 patterns" → #patterns; close "Explore Hanzo" → /)
- One h1; the page is clear in 5 seconds
- No dead or self-looping button; n/a: no prices on the page
- Open copy questions for James listed, none decided
Done here: Story page, one audience (builders and researchers judging how Hanzo thinks), metric philosophy.close. Copy question for James: the Lenses copy says "four modern minds" but Hanzo's data has one lens (Zen, 6 patterns), so the Lenses view shows "All lensed patterns" plus one chip; copy and data left as Hanzo has them. One solid ask per screen; "Build with Hanzo", "Read the research" and "View the source" are text links.
2. Information architecture and navigation
- One
<main id="main">; skip link reaches it - Every link through
A,Moreor a plain hash link; every stack row a real link - n/a: depth 1, no breadcrumb
- Link parity: 10/10, 0 removed
Done here: <main id="main"> takes the layout's "Skip to content"; links use the kit A and More; parity shows 10/10 links.
3. First impression and page narrative
- Sells in 5 s; something moves within 1 s without input (the hexagram draws itself and the h1 cuts in on CSS from first paint; the walk's first change follows 900 ms after mount)
- Hero: the hexagram is the one big thing; h1 52px by line mask; nothing above the h1 ("Philosophy" is a caption under it)
- JS off: legible; no
opacity:0on the LCP element - One idea per screen; sizes alternate (one moment per screen: hexagram, premise sentence, law hexagram, belief statement)
- Ends in the dark room's closing link ("Explore Hanzo"), then the footer
- n/a: no cards to other pages beyond the stack rows (they morph through the site layer)
Done here: First screen at 1470×801: centred hexagram (≈420px) walking the sixty-four, 52px headline, caption, lede and ask at its foot. Slice D: the h1 cut-in and the hexagram's bottom-to-top draw are CSS keyframes, so they run from first paint and never wait for hydration (measured on the dev server: h1 already moving on the first frame at 0.78 s, settled by 1.6 s). JS off: every word visible; only the Sequence tab panel stays hidden, and its words are in the laid-out sheet details.
4. Conversion system
- Kit ask (
.pf-btn.solid) only; no raw.x-btn - Sticky ask: the header's ask and the site's own bar read
data-thumb; no page-level floating bar - n/a: no copy button
data-cta="philosophy.hero"anddata-thumbon the primary;data-cta="philosophy.close"on the closing ask
Done here: The page's floating AskBar was removed (MASTER §3.2 rule 6); the site ask bar carries "Explore the 64 patterns" from data-thumb.
5. Trust and proof
- No logo, no seal, no invented number
- Every figure traces to Hanzo's copy (64, 8, the King Wen numbers)
- n/a: no marquee
- n/a: no form
Done here: The only figures are Hanzo's own (64 patterns, 8 trigrams, 5 laws, 8 steps); nothing is claimed beyond the copy.
6. Content presentation (copy untouched)
- No text under 13px except 12px mono capitals
- Headings 12–18ch, lede ≤ 44ch, body ≤ 66ch;
text-wrap: balanceon headings - Views are APG tabs with arrow keys; all 64 details in the HTML
python3 scripts/parity.py /philosophy: 437/437 text, 10/10 links
Done here: Sizes from ProofRhythm (h1 52, headings 26, titles 21, lede 20, body 16); detail lives in the pattern sheet (one per page, steps ← →), all 64 entries server-rendered.
7. Visual design system
taste.pypasses; only deck greys (#0a0a0a, #525252, #737373, #f5f5f5, #e4e4e7, #e5e5e5)- No label, tag, badge or pill above a headline
- Tiles are flat fills; rows divided by hairlines; only the sheet floats
- n/a: no icons beyond arrows and the hexagram glyphs
- Differs from neighbours: a centred line-art stage with the headline under it
Done here: Ink only; changing lines are marked by a dot, not a colour; the dark close enters as a rounded card and opens to full width (SceneWipe).
8. UI component library
- Every control has hover (inside
@media (hover: hover)), press (scale .97, 90 ms), focus-visible - Focus ring on every stop (hexagram lines, tiles, cells, steps, rows)
- The pattern sheet traps focus, Esc closes, focus returns to the tile
- n/a: no inputs
- Forks deleted: listed above
Done here: Hovers fill or part the hexagram's strokes (James's "strokes parting", 2–6px); no lift or scale on hover; presses scale .97. The pattern sheet is a native <dialog> (showModal()): focus trapped, Esc and the backdrop close it, focus returns to the cell that opened it; checked headless: opening it leaves scrollY unchanged and the closed sheet draws nothing (0×0) at 1470 and 375.
9. Motion and interaction
- Signature
timeline(MOTION-MAP): the five laws on a strip you drag; supporting: a line-mask cut-in on the h1, premise and stanza only, gliding view pill (300 ms ease-emphasis); 0 fade-ups, no pinned scene, no scroll scrub - Kinds: idle (hero walk, the laws timeline playing through once, premise line, laws' last line, one lap of the method ring), pointer and touch (drag the strip, strokes part, fills), state (sheet, pill); nothing is scroll-driven
- The hero moves without input; every control answers
- Reduced motion shows the final state; no
setInterval - n/a: sound is a shared kit, not wired on this page
Done here: The pinned laws scene (PinScenes) and the scroll word reveal of the belief statement are gone. The second screen is the signature: a timeline of the five operating laws; dragging the thumb (pointer or finger, touch-action: pan-y), tapping a law's number or pressing ← → / Home / End moves it, the law under it takes the panel (outgoing 150 ms, incoming 300 ms ease-emphasis) and the hexagram beside it gains one line per law, the sixth (64 · Before Completion) flipping six times on law 05; on release it settles on the nearest law in 300 ms ease-in-out. It plays 01 → 05 once by itself when first seen until touched; the thumb moves by transform only (CLS 0.001 desktop, 0.0006 phone while scrolling). The belief statement is now set still in ink and grey. Deck timings only, no springs or overshoot; variety.py OK. Entrances (MOTION-MAP row, page-local philosophy/enter.js + enter.css, in page order): typewriter on "Five operating laws" (steps per letter behind a caret that blinks twice), venetian-type on the premise's two lines (alternating sides), fold-out on the 64's view (rotateX from its top edge), invert-flash on the method ring (a black disc flicks back to light), side-carousel on the stack rows (ride in from the right, a row behind the next). One IntersectionObserver plays each once; start states only under html.js without reduced motion, so JS off and reduced motion show the final page. Probe at 1470 and 375 after a slow scroll: all five fired (data-in and data-done) and ended visible; reduced motion 0 console errors.
10. Media
- n/a: the page has no Hanzo photo or film; its objects are drawn (hexagrams, ring)
- n/a: no video
- n/a: no image
- n/a: no photo
Done here: Every object is drawn in HTML and CSS (the hexagram is 6 rows of two halves), so nothing loads. The hero's changing name and trigram lines keep fixed two-line, full-width boxes, so the walk moves nothing: measured CLS over 15 s idle 0.005 at 375×812 (was 0.125) and 0.008 at 1470×801.
11. Mobile and responsive
- 375×812 and 1470×801 pass with no overlap
- No horizontal scroll (phone.mjs 375/375); the matrix scrolls inside its own frame
- Every target 44px or more; tiles and rows answer taps
- Primary ask above the fold at 375 (moved above the lede)
Done here: Phone hero: a 150px hexagram whose lines sit in 44px tap pads, h1 at 40px, the ask before the lede; the laws timeline sets a 104px hexagram beside its caption, the law below, and the strip at full width with 44px number stops (drag with a finger). Nothing overlaps at 375 (the old closed-sheet overlap is gone; scrollWidth 375). The patterns open on the Matrix view (one 8×8 object) instead of eight rows of tiles; tile titles never break inside a word: measured with a Range per word at 1470, 1200, 900, 375 and 320 (six a row from 900, four below 1200, three on phones with 8px tile padding, two below 370px).
12. Accessibility (WCAG 2.2 AA)
- Text #0a0a0a / #525252 / #737373 on white, #525252 on #f5f5f5
- Pause control (LivePause, 44px,
aria-pressed) first in the hero stage; every other loop ends at rest - n/a: no forms
- One h1; h2 per section, h3 in groups and the sheet
- Keyboard reaches every line, tile, tab, cell and step
Done here: The hero walk has a pause button; the laws strip is a role="slider" (arrow keys, Home, End) with its value read as the law's name; the premise line, the laws' last line and the method ring stop after a few cycles; aria-live speaks only after a visitor changes a line.
13. Performance and engineering
- h1 and the hexagram in server HTML
- No images or video; CSS-only line art
- No poller; timers stop off screen (
useInView) - Filming and checks run in the cloud
Done here: All motion is transform, opacity and clip-path; timers are setTimeout chains that stop when unseen or paused.
14. SEO and machine files
- Title and description unchanged (
app/philosophy/page.jsx) - Canonical untouched (shared)
<JsonLd route="/philosophy" />renders- Stack rows are real links
Done here: Metadata and JSON-LD come from the route file, unchanged; every word is in the server HTML.
15. Catalogue and product pages
- n/a: not a catalogue or model page (the 64 patterns open in a sheet, not pages)
- n/a
- n/a
- n/a
Done here: n/a: a Story page; its index of 64 opens each pattern in the one sheet.
16. Developer experience
- n/a: no code on the page
- n/a
- n/a
- n/a
Done here: n/a: no code, terminal or config on /philosophy.
17. States and resilience
- Static content: no loading or error state; the lens view has Hanzo's empty-state line
- No live data
- n/a: no form
- JS off: a
<noscript>rule lays out all views and all 64 patterns; reduced motion shows final states
Done here: JS off: all words visible at 1470 (the Sequence view's panel is hidden, but each of its 64 entries is laid out in full in the sheet details); the sheet wraps 64 → 01; nothing on the page fetches.
18. Measurement and handover
data-ctaon both primaries (philosophy.hero,philosophy.close); n/a:lib/track.jswiring is shared- Nothing identifier-bearing
V2:line in the page file's top comment- Review read:
docs/build-notes/review/philosophy.md(7/10 on the walk before this build). In this build: the blank bands around the laws heading, the premise tail and above "Every hexagram is active" are cut; Sequence tiles run six a row at desktop widths so no name breaks mid-word; the questions section holds the question's trigram drawn large (walks the eight once, then follows the pointer), sticky beside the list; the closing statement is hydration-safe under reduced motion (0 console errors measured); text links are 44px tall. Not changed: the hero keeps its centred hexagram over the headline (the h1 sits low by design so the hexagram is the first screen's one big thing).
Done here: Filmed with scripts/motion.mjs (desktop) and scripts/shot.mjs (phone); gallery desktop.mp4, desktop.jpg, phone-1..3.jpg.