- 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
7.2 KiB
Cloud chats: shared rules and tasks (7 Nov)
James's 8 GB laptop could not run the chats, so the remaining work runs in the cloud. A local conductor chat merges each finished branch into James's copy, and he watches it on localhost:4180.
Shared rules (every cloud chat)
- The law, in order:
docs/build-notes/MASTER.md: the one brief (precedence, the 18 parts, the look, page types, mechanics, the coverage card).docs/build-notes/DONE.md: the finish line.
- Reviews decide "ready", not your own score. Cloud James-eye critics walk every pushed page and write
docs/build-notes/review/<page>.md, withVerdict: N/10and the first complaint. After everygit pull, read the reviews of your pages and fix anything under 8 before starting a new page. - Coverage. Each page you finish gets
docs/build-notes/coverage/<page>.md, copied fromdocs/build-notes/coverage/_TEMPLATE.md(MASTER.md section 6). - Setup. Run
npm ci, thennpm run dev(port 4180) in the background. - Filming. Cloud only, never on James's Mac. See MASTER.md section 5 (Filming and proof).
- Style. Hanzo's way: the smallest change that fully works, reuse the kit (
components/ui.jsx,components/kit.jsx), and review your own work before calling it done. Act as James: never ask him questions, and make the decisions yourself. - Ownership. Other cloud chats work on other files at the same time on their own branches, so touch only the files you own. Never edit
app/globals.css,lib/route.js,docs/build-notes/PAGES.md,components/ui.jsx,components/kit.jsxor another chat's pages. Report any shared change you need instead. - Safety. Never submit real forms or send real chat messages to Hanzo's live API; intercept requests, as
scripts/forms.mjsdoes. No deploys. - Shared
components/v2/files: reuse, never re-create. Before adding one, rungit pull --rebase origin mainand check whether it already exists. If it does, use it as it is. If it lacks something, build that piece page-local (components/pages/<your page>/...). Only add a brand-new v2 file if the name is free, and pull right before pushing it. Two chats creating the same file caused the first merge conflict (7 Nov 13:45). - Taste gate.
python3 scripts/unique.pynow also runsscripts/taste.pyon every page file you touch. It fails any UI hue (colour belongs only to Hanzo's media) and any label, tag or pill sitting directly above a headline. These are the critics' two most common complaints. If that label is Hanzo's own copy, keep the words but move them so they are not above the headline. Also fix any Next.js error badge (the red dev overlay) on your pages. - No PRs, no watching, no scheduled check-ins. The conductor merges every pushed branch into main within 2-10 minutes. Opening a PR and then waiting on it stalls you and needs approvals while James is away. After each push, pull main and carry straight on with the next page or fix. Only end your turn when every page you own has a critic verdict of 8 or more.
- Never stall on approvals. James is away, so a prompt waits until the conductor's next tick. Avoid commands that need manual approval, such as
rmwith globs: write each run into a fresh folder instead. Never ask to change cloud environment or network settings. Work with what you have and note what you need in your PR body. - Push after every page, not at the end. James watches the site build live on his localhost: the conductor merges every pushed commit about every 10 minutes. Commit and push each page as soon as it works.
- Mark it done. When a page meets MASTER.md, add this line to the top comment of its page file:
V2: <score>/10 <one line on what changed>. The status board reads that line; a page without it counts as not done. - Finish. Commit, push your branch, and push your branch (no PR needed). The PR body gives one line per page: what changed, the evidence (200, parity, unique) and what is unverified. James reads that list to know what to look at.
Tasks: Wave 1, the flagships that set the v2 bar
Each chat owns its pages' components/pages/... files, their app/<path>/ routes, and any components/v2/<Name>.jsx it creates (one file per piece, with a usage note at the top). Rebuild each page to MASTER.md; do not just patch it. Score each page 1–10 in the PR, and ship only 8 or better.
- Home
/, with the home sectionscomponents/Hero.jsx,Platform.jsx,Agents.jsx,Race.jsx,Cheaper.jsx,Pareto.jsx,Open.jsx,Pricing.jsx,Models.jsx. This is the bar-setter: Stage hero, chapters, cards that open (synchronized.studio). - Models:
/models(catalogue) + the/models/*template (components/ModelPage.jsx), read like the anthropic.com model launch. Keep the WebGL opener. - Enterprise + Pricing:
/enterprise(calm trust, like chatgpt.com/business/enterprise) and/pricing(rolling prices, a compare drawer). - Platform + Cloud:
/platform(a system map you zoom into) and the/cloud/*template, a launch page for each product. - Apps:
/chat,/dev,/agents. Each gets one live, self-running product demo as its hero. - Story:
/about,/history, and the/blogindex (editorial, osply/hamol/grubogrubo style).
Later waves (the conductor launches these after Wave 1 merges): the remaining ~120 pages in archetype groups of about 10 per chat, the families not covered above, Content/Data wiring for hard-coded figures, then Build / Release (npm run build exits 0, preview :4181).
Wave 2 (launched 7 Nov 13:30, in parallel with Wave 1, because James wants speed)
Same rules. Each chat owns its group's page files and routes. Page types are in MASTER.md section 4.
- Company:
/careers /contact /contact-sales /customers /solutions /support /team /press /investors /brand - Proof:
/benchmarks /compare /comparison /open-source /philosophy /research /security /trust /leaderboard /integrations - Apps 1:
/api /bot /chrome /cli /computer /design /desktop /download /extension /gen - Apps 2:
/ide /kata /mcp /operative /operator /skills /slack /studio /tag /sdks - Cloud 1:
/analytics /authz /base /crawl /dashboards /datastore /dns /edge /engine /functions - Cloud 2:
/gateway /guard /hsm /iam /identity /idv /ingress /insights /kms /machines - Cloud 3:
/metrics /mq /network /node /o11y /playground /pubsub /realtime /registry /s3 - Cloud 4:
/search /sentinel /stream /telemetry /tunnel /visor /world /auto /automations /billing - Business 1:
/blockchain /captable /commerce /console /dataroom /flow /gui /jin /ledger /payments - Business 2:
/risk /sign /tabs /treasury /ui /zap /legal /templates /features /gallery - Programs:
/affiliate /beta /bounty /buying-specialist /founder /grants /learn /newsletter /referral /sms-opt-in /startups - Zen family names:
/enso /iro /kai /koe /koma /mori /oto /uta /zen - Families A (templates; check 2 members each):
/benchmarks/* /oss/* /integrations/* /solutions/* /blockchain/* /legal/* /careers/* /products/* - Families B (templates; a local chat had started these at v1, so finish them to v2):
/blog/* /customers/* /agents/* /compare/* /help/* /zen/* /kai/*
Index pages and family templates are different files, so /customers (group 1) and /customers/* (group 14) do not collide.