--- id: "4.13" title: "The Brand Book we give brands, Ocho" dept: brand status: draft owner: Param branded: true direction: octopus last_verified: '2026-10-26' 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" --- # The Brand Book we give brands, Ocho ## 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 - 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] - 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] - Built after the brief, healed when missing or old, current version BOOK_V 6. [src: brew/brand-book-read.js:10-12,18] - Every maker reads it: drafts, cards, statics and the jam get its rules, voice, words and references. [src: memory brew-brand-book] - Shipped 23 October 2026. [src: memory brew-brand-book] ### Chapters | Chapter | | | |---|---|---| | 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] | | Products, People, Proof, The numbers | Products and price steps, people, ratings and reviews | [src: brew/public/brand-book.js:34-36] | | 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] | | 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] | ### Who sees what | Scope | Sees | | |---|---|---| | Member | Everything, including Meta winners, uploads and the team's rules and choices | [src: brew/jam2/brandbook.js:9,154,158] | | 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] | | Public | The read only, the free kit for brands only read | [src: brew/jam2/brandbook.js:10] | ### What it exports | Address | What it is | | |---|---|---| | `//brand` | The book as a read only page | [src: brew/brand-kit.js:4; brew/server.js:946-950] | | `//brand.md` | An AI ready brand prompt to paste into any AI tool | [src: brew/brand-kit.js:5; brew/server.js:936] | | `//brand.json` | The whole book as data, every line with its source | [src: brew/brand-kit.js:6; brew/server.js:938] | | `//llms.txt` | The index an AI agent reads first | [src: brew/brand-kit.js:7; brew/server.js:937] | | `//brand.pdf` | The book as a PDF | [src: brew/server.js:941; brew/brand-book-routes.js:93] | | `//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] | ### How it looks today - 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] - The public page loads the old name's mark as its favicon. [src: brew/server.js:948] - 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] ### Where it sits in tomorrow's plan - The books call it a gift every partner gets from the read, marked Today. [src: brand-directions/book/content/h2.js:104-116] - 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] - 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. - v1 Changes: the plain name on buttons is Your brand book, inside What we know about you, once the naming clash below is settled. - 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. - 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. - 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. - v1 Changes: the public page favicon becomes the brand's own logo, never the old name's mark. - 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. - 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. - v2 New: the brand book feeds posting rules once posting ships after a yes. Ocho's line stays draft first. - v3 New: results from How it went may add proof to the book, each with its source. - 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. 2. Before any Brand Book deploy, run the audit and the guards: ``` cd /Users/param/Documents/ChatGPT/brew && node tools/audit-brand-book.mjs DIR && node --test test/brand-book-guards.test.js ``` 3. Keep Ocho out of the book's chapters and files. The only Ocho is the 32 pixel sign off. 4. 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 | |---|---|---|---| | Books built | Brands with a brandbook-read.json at the current BOOK_V | brands//brandbook-read.json in storage | Proposed, not reported | | Book shares | Opens of `//brand` and downloads of the kit per week | Server logs for the public routes | Proposed | | 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. 2. 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.