What every partner's Brand Book holds and exports today, and how it is named, voiced and dressed in Scoop's direction, with the partner's own brand always in the lead.
Today
What it is
Every read builds the brand's whole profile from its own public evidence before anyone uploads anything. brew/brand-book-read.js:1
Free parts need no AI: products and price tiers, offers and guarantee, ratings, review lines, press and founders, channels, rivals and the library of the brand's own ads, posts and photos. brew/brand-book-read.js:4
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
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
Saved per brand as brandbook-read.json, version BOOK_V 6. brew/brand-book-read.js:18
One store serves the app and the studio: the read, then uploads, then the team's edits by path. brew/jam2/brandbook.js:8
Every maker reads it: drafts, cards, statics, ideas and the studio's creative engine. memory brew-brand-book
It rebuilds when its inputs change, no more than once every 6 hours and at most weekly. memory brew-brand-book
The read plus the team's edits that are not private
brew/jam2/brandbook.js:164
Public
The read only
brew/jam2/brandbook.js:133
Closed stores
No public book
memory brew-brand-book
What it exports
Route
What it is
Source
/<slug>/brand
The book as a read only page
brew/brand-kit.js:4
/<slug>/brand.md
An AI ready brand prompt to paste into ChatGPT, Claude or Gemini
brew/brand-kit.js:5
/<slug>/brand.json
The whole book as data, every line with where it came from
brew/brand-kit.js:6
/<slug>/llms.txt
The index an AI agent reads first
brew/brand-kit.js:7
/<slug>/brand.pdf
The book as a PDF
brew/server.js:941
/<slug>/brand-kit.zip
All of it plus W3C design tokens, colors.css, an .ase palette, logos, references by format, product photos and project notes for Claude and ChatGPT
brew/brand-kit.js:8; brew/brand-kit.js:101
Guards
Issue classes fixed on 23 Oct are guarded for every brand: search snippets as cover lines, never say words shown as code, they and their in labels, empty proof tiles, uploads grounded in the file. memory brew-brand-book-guards
Before any Brand Book deploy, run the audit and the guards test. brew/tools/audit-brand-book.mjs; brew/test/brand-book-guards.test.js
The public page today loads the old name's mark as its favicon. brew/server.js:948
In Scoop's audition files
Fact
Detail
Source
Scoop's word for the export
The dossier: your house rules on one page, tagged Later as brand sheet export
brand-directions/raccoon/brand.html b3
Brief page sign off
Read by Scoop. Shipped by you.
brand-directions/raccoon/kit-skin.js:88
Gift line
Psst. I wrote down everything your store says about itself. It is a brand book now, and it is yours.
brand-directions/book/content/h2.js h-11
Rule
A person, never Scoop, handles money, privacy, apologies and anyone upset
brand-directions/raccoon/system.md s3
The audition book tags the export Later, but the Brand Book shipped on 23 Oct. That tag is stale. memory brew-brand-book; brand-directions/raccoon/brand.html b3
Tomorrow
v1, Stays: the chapters, scopes, routes, guards and the rule that nothing is invented.
v1, Changes: the plain name stays Brand Book on buttons and in the share sheet. Scoop's word, the dossier, lives only in the sentence around it.
v1, Changes: the book is dressed in the partner's own colours, fonts and pictures, never in tangerine, Gloock or Schibsted Grotesk. Our skin frames the app around it, never the book.
v1, New: Scoop appears in exactly two places: one line in What we know about you, where Share your brand book sits, and a 32 px sign off at the foot of the shared page, Read by Scoop. Shipped by you.
v1, New: Scoop never appears on the cover, on chapters, in brand.md, brand.json, llms.txt, the PDF or the kit zip. Those files belong to the brand.
v1, New: the public page says what it is built from, in Scoop's terms: public pages for the read, plus anything the team added.
v1, Changes: the public page's favicon and footer use the new small mark and the wordmark slot, never the old mark.
v1, New: when What AI search says finds a gap, Scoop points to the Brand Book as the fix: I asked the chatbots. Share this so they know you.
v2, New: every post the brand approves to go out follows the book's rules for its channel.
v3, New: the library marks which of the brand's own work did best, with its source.
v4, New: ads that run within the brand's rules read their limits from the book's Rules chapter.
How we do it
Change the Brand Book only in brew code, never in saved data by hand, and heal every brand.
Before any deploy, copy a brand's bucket files into a folder and run:
cd /Users/param/Documents/ChatGPT/brew && node tools/audit-brand-book.mjs DIR && node --test test/brand-book-guards.test.js
Never leak member data into share or public: Meta best ads, uploads, private edits and team rules stay members only.
Write any line around the book in Scoop's voice from raccoon/system.md, and keep every line inside the book in the brand's own voice.
Add a guard test for every new issue class found.
Numbers
Metric
Definition
Where measured
Status
Books built
Brands with a current brandbook-read.json at BOOK_V 6
Bucket listing per brand
Proposed
Shared opens
Visits to /<slug>/brand and its files from outside the team
Server logs
Proposed
Empty fields
Book fields left empty for lack of evidence
tools/audit-brand-book.mjs output
Proposed
Guard failures
Guard test failures before a deploy, target zero
test/brand-book-guards.test.js
Exists
Open
Should Scoop sign the shared page at all? Proposal: yes, one 32 px sign off at the foot only, since the brand leads every other part.
Does the dossier replace Brand Book as the user word in Scoop's direction? Proposal: no, Brand Book stays the plain word on every control, the dossier lives only in Scoop's sentence.
Sources
brew origin/main a559de6 brand-book-read.js lines 1 to 18, 25 to 30
brew origin/main jam2/brandbook.js lines 8, 132 to 164, 184
brew origin/main brand-kit.js lines 1 to 9, 89 to 114
brew origin/main server.js lines 936 to 950
brew origin/main public/brand-book.js lines 34 to 37, 147
