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
Every read builds the brand's whole profile from its own public evidence, before anyone uploads a thing, saved as brands/<slug>/brandbook-read.json. brew/brand-book-read.js:1 to 12
Shipped 23 October 2026. Current build version BOOK_V 6. memory brew-brand-book; brew/brand-book-read.js:18
Free parts need no AI: products and price tiers, offers and guarantee, ratings, review lines, press and founders, channels, rivals, and the creative library. brew/brand-book-read.js:4 to 5
One AI call writes story, voice, words, claims, look, type use, naming, colour roles, playbooks and what makes each reference theirs. brew/brand-book-read.js:6 to 7
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. brew/brand-book-read.js:8 to 9
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. brew/brand-book-read.js:25
It rebuilds when its inputs change and it is at least 6 hours old, and at least weekly. brew/brand-book-read.js:306
Who reads it
One store in jam2/brandbook.js lays uploads and team edits over the read. brew/jam2/brandbook.js:132
Three scopes: member sees everything, share adds the team's edits that are not private, public is the read only. brew/jam2/brandbook.js:132; memory brew-brand-book
Every maker reads it: promptBlock for writing, creativeBlock and refsFor for pictures and video. brew/jam2/brandbook.js:38; brew/jam2/brandbook.js:50; brew/jam2/brandbook.js:80
The team can ask for changes in words, import their own brand book as a file, ZIP, link or text, and refresh it. brew/brand-book-routes.js:4; brew/brand-book-routes.js:120; brew/brand-book-routes.js:168; brew/brand-book-routes.js:187
Members only data, such as Meta winners, uploads and team rules, never reaches share or public. memory brew-brand-book-guards
What it exports
Address
What it is
/<slug>/brand
The book as a read only page brew/brand-kit.js:4
/<slug>/brand.md
An AI ready brand prompt for ChatGPT, Claude or Gemini brew/brand-kit.js:5
/<slug>/brand.json
The whole book as data, every line with its source brew/brand-kit.js:6
/<slug>/llms.txt
The index an AI agent reads first brew/brand-kit.js:7
/<slug>/brand.pdf
Print ready, every chapter brew/server.js:941; brew/public/brand-book.js:399
/<slug>/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 brew/brand-kit.js:8 to 9; brew/brand-kit.js:99 to 106
How it looks today
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. brew/public/brand-book.js:1 to 5
Chapters are spreads in three tones, paper, their colour and ink, set per chapter. brew/public/brand-book.js:147; memory brew-brand-book
The shared page still uses the old mark as its tab icon. brew/server.js:948
No character appears in the book today. 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.
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.
v1, Changes: the tab icon on the shared page becomes bee/char-mark-16.svg and the old mark goes.
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.
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.
v1, Stays: nothing invented, every line with its source, members only data never shared.
v2, Changes: the book feeds every post the brand approves when the product posts after a yes.
v3, New: the library marks which of the brand's own work did best, with a source on every number.
v4, Stays: ads within rules follow the book's claims and never say list.
How we do it
Never put Buzz inside the partner's book. One small mark and one sign off line at the foot only.
Never put pollen yellow on the partner's chapters. Their accent colour leads.
Before any Brand Book deploy, run the audit and the guard tests.
cd /Users/param/Documents/ChatGPT/brew && node tools/audit-brand-book.mjs DIR && node --test test/brand-book-guards.test.js
Every new issue class gets a check in the audit and a guard test, for every brand.
Numbers
Metric
Definition
Where measured
Status
Books built
Brands with a current brandbook-read.json at BOOK_V 6
Bucket listing of brands/*/brandbook-read.json
Proposed
Book shares
Opens of /<slug>/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
Empty fields
Share of AI fields left empty for lack of evidence
brandbook-read.json per brand
Proposed
Open
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.
Sources
brew origin/main brand-book-read.js:1 to 12, 18, 25, 245, 306
