Answer
Every Buzz file that exists, where it lives and how to use it, next to the assets today's product ships, so nobody redraws or re-records what is already there.
Today
Character masters and marks
| File | What it is | Use |
|---|---|---|
| bee/char.svg | The master, hovering and waving | Hero, stage, idle slot above 120 pixels brand-directions/bee/kit-skin.js art.idle |
| bee/char-mark.svg | Small mark: ball, two stripes, kinked feeler, one wing, two eyes | Today corner, app icon, avatar, anything 20 to 120 pixels brand-directions/bee/system.md s4 |
| bee/char-mark-16.svg | 16 pixel mark, no wing, one eye | Favicon, anything under 20 pixels brand-directions/bee/system.md s4 |
| bee/svg/sheet.svg | Model sheet: construction, three quarter views, silhouettes, mark ladder | Reference for any illustrator brand-directions/bee/svg; brand-directions/bee/character.html c2 |
Poses
| File | Moment | Product slot |
|---|---|---|
| bee/svg/pose-idle.svg | Idle | Today header above 120 pixels brand-directions/bee/character.html c4 |
| bee/svg/pose-paste.svg | Paste | First screen brand-directions/bee/kit-skin.js art.paste |
| bee/svg/pose-reading.svg | The read | Reading your store, 120 to 180 pixels brand-directions/bee/kit-skin.js art.wait |
| bee/svg/pose-drop.svg | The Monday drop waggle | The reveal, 160 pixels brand-directions/bee/kit-skin.js art.drop |
| bee/svg/pose-heart.svg | Heart | Heart celebration brand-directions/bee/kit-skin.js art.heart |
| bee/svg/pose-make.svg | Make it | Making wait brand-directions/bee/kit-skin.js art.make |
| bee/svg/pose-handoff.svg | Hand it off | Brief copied brand-directions/bee/kit-skin.js art.handoff |
| bee/svg/pose-caught.svg | Caught up | Caught up screen brand-directions/bee/kit-skin.js art.caught |
| bee/svg/pose-error.svg | Error | Errors and cap reached brand-directions/bee/kit-skin.js art.error |
| bee/svg/pose-celebrate.svg | Celebrate | First win, 120 pixels brand-directions/bee/kit-skin.js art.celebrate |
| bee/svg/pose-empty.svg | Empty | Empty states brand-directions/bee/kit-skin.js art.empty |
| bee/svg/pose-wait.svg | Wait | Marketing and stage only, never a product spinner brand-directions/bee/character.html c4 |
Expressions, modes and growth
| File | What it is | Use |
|---|---|---|
| bee/svg/expr-happy.svg, expr-focus.svg, expr-grin.svg, expr-curious.svg, expr-oops.svg, expr-sleepy.svg, expr-delight.svg, expr-determined.svg | The eight faces | One per moment, held brand-directions/bee/svg; brand-directions/bee/character.html c3 |
| bee/svg/pose-mode-social.svg, pose-mode-ads.svg, pose-mode-website.svg, pose-mode-ai.svg, pose-mode-email.svg | The five area props: camera, trumpet flower, shop front, speech bubble, envelope | Art and marketing for an area. Never as the area tag itself brand-directions/bee/svg; brand-directions/bee/character.html c9 |
| bee/svg/pose-grow-doer.svg, pose-grow-reporter.svg | Approve stamp, scorecard | Later only, labelled Later brand-directions/bee/svg; brand-directions/bee/character.html c10 |
Sound
| File | What it is | Use |
|---|---|---|
| bee/snd/logo.mp3 | Sonic logo, 2.6 s | End cards, stage, first open brand-directions/bee/motion.html v0 |
| bee/snd/cue-heart.mp3, cue-ready.mp3, cue-handoff.mp3, cue-error.mp3, cue-caught.mp3 | Five cues | Heart, read ready, brief copied, error, caught up brand-directions/bee/kit-skin.js sounds |
| bee/snd/line-paste.mp3, line-read.mp3, line-drop.mp3, line-heart.mp3, line-handoff.mp3, line-caught.mp3, line-error.mp3, line-tagline.mp3 | Eight lines in Buzz voice | Stage, marketing, onboarding once brand-directions/bee/snd/sound-log.json |
| bee/snd/voice-option-1.mp3 to voice-option-3.mp3, voice-options.json, voice.json | The three voice tries and the kept one, option 1 | Reference. New lines use the voice in voice.json brand-directions/bee/snd/voice.json |
| bee/snd/sound-log.json | Every prompt and line used | Re-making or extending a sound brand-directions/bee/snd/sound-log.json |
Type, tokens and templates
| File | What it is | Use |
|---|---|---|
| Shrikhand, Parkinsans from Google Fonts | Display and body faces | kit-skin.js fonts link brand-directions/bee/kit-skin.js fonts |
| Playpen Sans from Google Fonts | Hand notes | Books and marketing only brand-directions/bee/system.md s1 |
| bee/kit-skin.js | Product tokens, art slots, motion and every product line | The screen kit and tomorrow's product skin brand-directions/bee/kit-skin.js |
| bee/skin.css | Book tokens | Books, site, marketing brand-directions/bee/system.md s1 |
| bee/img/kit/dark, bee/img/kit/light | 54 skinned screen shots in each theme folder | Reviews and decks brand-directions/bee/img/kit |
| bee/stage.js | Buzz for the audition stage, ids prefixed | Stage only brand-directions/bee/system.md s4 |
| bee/_src/rig/buzz.py, bee/_src/rig/poses.py | The rig and pose code that draws every frame | The only way to make a new frame brand-directions/bee/character.html c11 |
| bee/_src/*.html, bee/_src/build.py | Sources of the books | Edit these, never the built pages brand-directions/bee/system.md s4 |
| _shared/sample/img/monsoon.jpg, chai.jpg, jasmine.jpg, ad-rain.jpg, hands.jpg | The sample candle store | Every invented example, with a Sample label brand-directions/_shared/sample/img |
Today's product assets
| File | What it is |
|---|---|
| brew/public/assets/brew-mark.svg | The old mark, used as the tab icon brew/public/index.html:1 |
| brew/public/icons/icon-192.png, icon-512.png, maskable-512.png, apple-touch-icon.png | App icons brew/public/icons |
| brew/public/assets/agent-performance.svg, agent-storefront.svg | Agent shapes brew/public/assets |
| brew/public/sfx/*.mp3 | 29 product cues memory brew-sounds; brew/public/sfx |
| Inter, Caveat from Google Fonts | Today's product type brew/public/index.html:6 |
Gaps
- No final illustrator art: every frame is code drawn from the rig. brand-directions/bee/character.html c11
- No designed sticker yet. brand-directions/book/content/f2.js f-10 small-things
- No app icon PNG set for Buzz in the product sizes. brand-directions/bee folder listing
- No Buzz versions of the five cues levelled to the product's own LUFS targets. brand-directions/bee/motion.html v0; brew/tools/sfx/cues.json
Tomorrow
- v1, New: on the pick,
bee/char-mark.svgandchar-mark-16.svgreplacebrew-mark.svgand the app icons are rendered from the mark on pollen yellow. - v1, Changes: final art is redrawn by an illustrator from the rig, and the rig is updated so every new frame still comes from code.
- v1, New: the five cues are re-levelled and copied into
brew/public/sfxat the matching cue names. - v1, Goes: Inter and Caveat in the product.
- v1, Stays: the sample candle store images for every invented example.
- v2, New: doer props drawn live when posting exists. v3, New: reporter props when How it went exists.
- v4, Stays: no new character files, ever. Only props and poses.
How we do it
- Look here first. Reuse a file before making one.
- New frame: write it into
bee/system.md, add it to the rig, render, check at 512 and 24 pixels. - New sound: reuse first, then one prompt in the same family, logged in
snd/sound-log.json. - Rebuild the book pages from
_src, never edit built pages.
cd /Users/param/Documents/ChatGPT/brand-directions/bee/_src && python3 build.py
Numbers
| Metric | Definition | Where measured | Status |
|---|---|---|---|
| Frames on rig | Share of Buzz frames drawn by buzz.py | bee/svg compared with the rig output | Proposed, target all |
| Unused files | Assets not referenced by kit-skin.js, a book or the stage | A grep over brand-directions | Proposed |
Open
- Who makes the final Buzz art and app icons if Buzz is picked? Proposal: one paid illustrator redraws the master, mark and twelve poses from the rig, then the rig is matched to the redraw.
- Should the books' screen shots in img/kit be kept after the pick? Proposal: keep them as history, regenerate from the real product once skinned.