{ "id": "4.13", "title": "The Brand Book we give brands", "department": "Brand", "department_slug": "brand", "direction": { "id": "bee", "name": "Buzz" }, "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/bee", "markdown": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/bee.md", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/bee.json" }, "other_directions": [ { "id": "dog", "name": "Fetch", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/dog.json" }, { "id": "raccoon", "name": "Scoop", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/raccoon.json" }, { "id": "octopus", "name": "Ocho", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/octopus.json" }, { "id": "cooker", "name": "Seeti", "json": "https://handbook.joinsquareup.com/brand/the-brand-book-we-give-brands/cooker.json" } ], "tldr": { "headline": "The brand's whole book, pressed like honey, Buzz signs the foot", "points": [ { "icon": "book", "text": "Every read builds the brand's whole profile from its own public evidence." }, { "icon": "lock", "text": "Nothing is invented, and members only data never reaches share or public." }, { "icon": "link", "text": "Exports: a page, brand.md, brand.json, llms.txt, a PDF and a kit zip." }, { "icon": "eye", "text": "Never any pollen yellow on the partner's chapters; their accent leads." }, { "icon": "heart", "text": "Buzz signs once: Drafted by Buzz. Over to you." } ], "stat": { "value": "32", "label": "pixel sign off mark" }, "decide": "Should Buzz appear in the partner's Brand Book at all, beyond the sign off?", "mood": "building" }, "sources": [ "brew origin/main brand-book-read.js:1 to 12, 18, 25, 245, 306", "brew origin/main jam2/brandbook.js:38, 50, 80, 132, 184", "brew origin/main brand-book-routes.js:4, 93, 120, 168, 187", "brew origin/main brand-kit.js:1 to 9, 66, 89, 99 to 106", "brew origin/main server.js:936 to 948", "brew origin/main public/brand-book.js:1 to 5, 147, 399", "brand-directions/book/content/h2.js h-11 brand-book", "brand-directions/book/content/h.js, the two public pages", "brand-directions/bee/system.md s2, s4", "brand-directions/bee/kit-skin.js words.briefSignoff", "memory brew-brand-book, brew-brand-book-guards" ], "open_questions": [ "Should Buzz appear in the partner's Brand Book at all? Proposal: only the 32 pixel sign off at the foot, the same rule as the brief page.", "Should the PDF and kit carry the sign off too? Proposal: the PDF yes, at the foot of the last page; the kit files no, they stay pure data for AI tools." ], "parts": { "Answer": "What a partner brand's Brand Book holds and exports, and how it is dressed in Buzz's direction: the partner's brand leads every page, Buzz only signs off.", "Today": "### What it is\n\n- Every read builds the brand's whole profile from its own public evidence, before anyone uploads a thing, saved as `brands//brandbook-read.json`. [src: brew/brand-book-read.js:1 to 12]\n- Shipped 23 October 2026. Current build version `BOOK_V` 6. [src: memory brew-brand-book; brew/brand-book-read.js:18]\n- Free parts need no AI: products and price tiers, offers and guarantee, ratings, review lines, press and founders, channels, rivals, and the creative library. [src: brew/brand-book-read.js:4 to 5]\n- One AI call writes story, voice, words, claims, look, type use, naming, colour roles, playbooks and what makes each reference theirs. [src: brew/brand-book-read.js:6 to 7]\n- Nothing is invented: every AI line names its evidence, quoted lines are checked against it in code, and a field with no evidence stays empty. [src: brew/brand-book-read.js:8 to 9]\n- The library sorts the brand's own work by deliverable: best ads, image, video and carousel ads, Instagram posts, reels and carousels, TikTok, YouTube, product photos, site photos, emails. [src: brew/brand-book-read.js:25]\n- It rebuilds when its inputs change and it is at least 6 hours old, and at least weekly. [src: brew/brand-book-read.js:306]\n\n### Who reads it\n\n- One store in `jam2/brandbook.js` lays uploads and team edits over the read. [src: brew/jam2/brandbook.js:132]\n- Three scopes: member sees everything, share adds the team's edits that are not private, public is the read only. [src: brew/jam2/brandbook.js:132; memory brew-brand-book]\n- Every maker reads it: `promptBlock` for writing, `creativeBlock` and `refsFor` for pictures and video. [src: brew/jam2/brandbook.js:38; brew/jam2/brandbook.js:50; brew/jam2/brandbook.js:80]\n- The team can ask for changes in words, import their own brand book as a file, ZIP, link or text, and refresh it. [src: brew/brand-book-routes.js:4; brew/brand-book-routes.js:120; brew/brand-book-routes.js:168; brew/brand-book-routes.js:187]\n- Members only data, such as Meta winners, uploads and team rules, never reaches share or public. [src: memory brew-brand-book-guards]\n\n### What it exports\n\n| Address | What it is |\n|---|---|\n| `//brand` | The book as a read only page [src: brew/brand-kit.js:4] |\n| `//brand.md` | An AI ready brand prompt for ChatGPT, Claude or Gemini [src: brew/brand-kit.js:5] |\n| `//brand.json` | The whole book as data, every line with its source [src: brew/brand-kit.js:6] |\n| `//llms.txt` | The index an AI agent reads first [src: brew/brand-kit.js:7] |\n| `//brand.pdf` | Print ready, every chapter [src: brew/server.js:941; brew/public/brand-book.js:399] |\n| `//brand-kit.zip` | All of it plus W3C design tokens, colors.css, an .ase palette, logos, fonts, references by format, product photos and project notes for Claude and ChatGPT [src: brew/brand-kit.js:8 to 9; brew/brand-kit.js:99 to 106] |\n\n### How it looks today\n\n- The book is dressed in the brand itself: their colour and logo on the cover, their heading font on every chapter, their colour chips. Our chrome stays quiet around it. [src: brew/public/brand-book.js:1 to 5]\n- Chapters are spreads in three tones, paper, their colour and ink, set per chapter. [src: brew/public/brand-book.js:147; memory brew-brand-book]\n- The shared page still uses the old mark as its tab icon. [src: brew/server.js:948]\n- No character appears in the book today. [src: brew/public/brand-book.js]", "Tomorrow": "- v1, Stays: the book is the partner's, dressed in their colours, fonts and pictures. Buzz never sits on a chapter, a colour chip, a product photo or a quoted line.\n- v1, Changes: Buzz signs off once, at the foot of the page, as the 32 pixel small mark and one line in Parkinsans: Drafted by Buzz. Over to you.\n- v1, Changes: the tab icon on the shared page becomes `bee/char-mark-16.svg` and the old mark goes.\n- v1, New: Buzz's words live around the book, never in it: the share button stays plain, Share your brand book, and the line beside it can read: Every petal of your brand, pressed into one book.\n- v1, Stays: the plain name Brand Book on every control. Buzz's word for memory, What sticks, may appear only in What we know about you, where the book is opened.\n- v1, Stays: nothing invented, every line with its source, members only data never shared.\n- v2, Changes: the book feeds every post the brand approves when the product posts after a yes.\n- v3, New: the library marks which of the brand's own work did best, with a source on every number.\n- v4, Stays: ads within rules follow the book's claims and never say list.", "How we do it": "1. Never put Buzz inside the partner's book. One small mark and one sign off line at the foot only.\n2. Never put pollen yellow on the partner's chapters. Their accent colour leads.\n3. Before any Brand Book deploy, run the audit and the guard tests.\n\n```sh\ncd /Users/param/Documents/ChatGPT/brew && node tools/audit-brand-book.mjs DIR && node --test test/brand-book-guards.test.js\n```\n\n4. Every new issue class gets a check in the audit and a guard test, for every brand.", "Numbers": "| Metric | Definition | Where measured | Status |\n|---|---|---|---|\n| Books built | Brands with a current brandbook-read.json at BOOK_V 6 | Bucket listing of brands/*/brandbook-read.json | Proposed |\n| Book shares | Opens of `//brand`, brand.md, llms.txt and brand-kit.zip per brand per week | Server logs for the public routes | Proposed, not logged as a metric today |\n| Empty fields | Share of AI fields left empty for lack of evidence | brandbook-read.json per brand | Proposed |", "Open": "1. Should Buzz appear in the partner's Brand Book at all? Proposal: only the 32 pixel sign off at the foot, the same rule as the brief page.\n2. Should the PDF and kit carry the sign off too? Proposal: the PDF yes, at the foot of the last page; the kit files no, they stay pure data for AI tools." } }