{ "id": "4.13", "title": "The Brand Book we give brands", "department": "Brand", "department_slug": "brand", "direction": { "id": "octopus", "name": "Ocho" }, "branded": true, "status": "draft", "owner": "Param", "last_verified": "2026-10-26", "holds": "What a partner's Brand Book holds and exports", "urls": { "html": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/octopus", "markdown": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/octopus.md", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/octopus.json" }, "other_directions": [ { "id": "dog", "name": "Fetch", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/dog.json" }, { "id": "bee", "name": "Buzz", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/bee.json" }, { "id": "raccoon", "name": "Scoop", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/raccoon.json" }, { "id": "cooker", "name": "Seeti", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/cooker.json" } ], "tldr": { "headline": "One arm made you a brand book while seven read", "points": [ { "icon": "book", "text": "Every read builds the brand's whole book, and the brand leads every page." }, { "icon": "lock", "text": "Nothing private ever reaches share or public." }, { "icon": "eye", "text": "No pink, no DynaPuff, no sucker print on the book itself." }, { "icon": "chat", "text": "Ocho appears once, at the end: Drafted by Ocho. Over to you." }, { "icon": "warn", "text": "Ocho's lines never claim the book is verified, approved or guaranteed." } ], "stat": { "value": "32", "label": "pixel sign off mark" }, "decide": "Brand book or brand sheet: which name wins everywhere?", "mood": "building" }, "sources": [ "brew origin/main a559de6: brand-book-read.js:1-18; jam2/brandbook.js:9-10,132-164; brand-kit.js:1-9,89-114; server.js:936-950; brand-book-routes.js:93; public/brand-book.js:34-36; tools/audit-brand-book.mjs; test/brand-book-guards.test.js", "brand-directions/book/content/h2.js:104-139 h-11 Your brand book", "brand-directions/_shared/ia.md:44,60,117", "brand-directions/_shared/product-model.md:62,88", "brand-directions/octopus/system.md s2, s4, s6", "brand-directions/octopus/brand.html b4", "memory brew-brand-book, brew-brand-book-guards, brand-directions-2026-10-25" ], "open_questions": [ "Brand book or brand sheet: the shared IA says brand sheet, your 25 October rule says brand book. Proposal: brand book everywhere, and update the shared IA and product model to match.", "Should Ocho sign off the public book page at all? Proposal: yes, the 32 pixel small mark and one line at the very end, so the book is clearly a gift from us and still the brand's own." ], "parts": { "Answer": "What every partner brand's Brand Book holds and exports today, and how it is named and dressed in Ocho's direction tomorrow: the partner's own brand leads every page, and Ocho only signs it off in one small corner.", "Today": "### What it is\n- The brand's whole profile, built from its own public evidence before anyone uploads a thing, then laid over with uploads and the team's edits. [src: brew/brand-book-read.js:1-12; brew/jam2/brandbook.js:9-10]\n- Every AI line names the evidence it came from, and quoted lines are checked against that evidence in code. No evidence leaves the field empty, never a guess. [src: brew/brand-book-read.js:7-9]\n- Built after the brief, healed when missing or old, current version BOOK_V 6. [src: brew/brand-book-read.js:10-12,18]\n- Every maker reads it: drafts, cards, statics and the jam get its rules, voice, words and references. [src: memory brew-brand-book]\n- Shipped 23 October 2026. [src: memory brew-brand-book]\n\n### Chapters\n| Chapter | | |\n|---|---|---|\n| Story, Look and kit, Voice, Words | The brand's own story, colours, type and how it talks | [src: brew/public/brand-book.js:34-36] |\n| Products, People, Proof, The numbers | Products and price steps, people, ratings and reviews | [src: brew/public/brand-book.js:34-36] |\n| What the brand publishes, Playbooks | Its own creative by deliverable, best first, and format playbooks | [src: brew/public/brand-book.js:34-36; brew/brand-book-read.js:27-31] |\n| Where the brand shows up, Rivals, Rules | Channels, rivals, and rules for claims, people, AI and safety | [src: brew/public/brand-book.js:34-36; memory brew-brand-book] |\n\n### Who sees what\n| Scope | Sees | |\n|---|---|---|\n| Member | Everything, including Meta winners, uploads and the team's rules and choices | [src: brew/jam2/brandbook.js:9,154,158] |\n| Share | The read plus the team's edits that are not private, for the share link and the kit | [src: brew/jam2/brandbook.js:9,164] |\n| Public | The read only, the free kit for brands only read | [src: brew/jam2/brandbook.js:10] |\n\n### What it exports\n| Address | What it is | |\n|---|---|---|\n| `//brand` | The book as a read only page | [src: brew/brand-kit.js:4; brew/server.js:946-950] |\n| `//brand.md` | An AI ready brand prompt to paste into any AI tool | [src: brew/brand-kit.js:5; brew/server.js:936] |\n| `//brand.json` | The whole book as data, every line with its source | [src: brew/brand-kit.js:6; brew/server.js:938] |\n| `//llms.txt` | The index an AI agent reads first | [src: brew/brand-kit.js:7; brew/server.js:937] |\n| `//brand.pdf` | The book as a PDF | [src: brew/server.js:941; brew/brand-book-routes.js:93] |\n| `//brand-kit.zip` | All of it plus design tokens, colors.css, an .ase palette, logos, references by format, product photos and project notes for Claude and ChatGPT | [src: brew/brand-kit.js:8-9,99-101; brew/server.js:943] |\n\n### How it looks today\n- Dressed in the partner's own colours and fonts, as spreads, with a cover collage of the brand's best work. [src: memory brew-brand-book]\n- The public page loads the old name's mark as its favicon. [src: brew/server.js:948]\n- Every guarded issue class from 23 October is checked by an audit tool and a guard test across all brands and scopes. [src: brew/tools/audit-brand-book.mjs; brew/test/brand-book-guards.test.js; memory brew-brand-book-guards]\n\n### Where it sits in tomorrow's plan\n- The books call it a gift every partner gets from the read, marked Today. [src: brand-directions/book/content/h2.js:104-116]\n- The shared IA puts it inside What we know about you as Share your brand sheet, and the product model lists Brand Book as a page name not to use. [src: brand-directions/_shared/ia.md:44,60; brand-directions/_shared/product-model.md:62,88]\n- On 25 October the owner asked for brand sheet to be renamed brand book everywhere, so the shared IA and the owner's newer rule disagree. [src: memory brand-directions-2026-10-25]", "Tomorrow": "- v1 Stays: what it holds, the three scopes and every export. Nothing private ever reaches share or public.\n- v1 Changes: the plain name on buttons is Your brand book, inside What we know about you, once the naming clash below is settled.\n- v1 New: the book lives inside What we know about you, which Ocho calls Grip. The line beside the share button is the one already written for Ocho: One arm made you a brand book while seven read. Your colours, your words, yours to share.\n- v1 Stays: the partner's own brand leads. Their colours, fonts, logo and photos dress every page. No pink, no DynaPuff, no sucker print on the book itself.\n- v1 New: Ocho appears in one place only, a 32 pixel small mark and one line at the end of the public page, the same sign off as the brief page: Drafted by Ocho. Over to you.\n- v1 Changes: the public page favicon becomes the brand's own logo, never the old name's mark.\n- v1 Goes: Ocho never appears in brand.md, brand.json, llms.txt, the PDF or the kit, because AI tools and designers read those as the brand's own voice.\n- v1 Stays: Ocho's book lines never claim the book is verified, approved or guaranteed. They say drafted from your public pages, and confirm anything unsure.\n- v2 New: the brand book feeds posting rules once posting ships after a yes. Ocho's line stays draft first.\n- v3 New: results from How it went may add proof to the book, each with its source.\n- v4 Stays: the book's rules are the limits an arm acts within when ads run within rules.", "How we do it": "1. Never change what the book holds or exports as part of the brand work. Restyle only around it.\n2. Before any Brand Book deploy, run the audit and the guards:\n ```\n cd /Users/param/Documents/ChatGPT/brew && node tools/audit-brand-book.mjs DIR && node --test test/brand-book-guards.test.js\n ```\n3. Keep Ocho out of the book's chapters and files. The only Ocho is the 32 pixel sign off.\n4. Any line around the book follows Ocho's voice rules: fact first, two sentences at most, no claims of results.", "Numbers": "| Metric | Definition | Where measured | Status |\n|---|---|---|---|\n| Books built | Brands with a brandbook-read.json at the current BOOK_V | brands//brandbook-read.json in storage | Proposed, not reported |\n| Book shares | Opens of `//brand` and downloads of the kit per week | Server logs for the public routes | Proposed |\n| Uncited lines dropped | Lines the verify step removed per build | brand-book-read.js verify | Proposed |", "Open": "1. Brand book or brand sheet: the shared IA says brand sheet, your 25 October rule says brand book. Proposal: brand book everywhere, and update the shared IA and product model to match.\n2. Should Ocho sign off the public book page at all? Proposal: yes, the 32 pixel small mark and one line at the very end, so the book is clearly a gift from us and still the brand's own." } }