---
id: '1.13'
title: Decisions log
dept: company-and-strategy
status: generated
owner: Param
branded: false
last_verified: '2026-10-26'
sources:
  - brand-directions/docs2/content/decisions.mjs
---

# Decisions log

## Answer

Every call made about Brew, newest first, with why. Never deleted; a reversed call stays and says so.

## Today

| When | Decision | Why, and what it means |
|---|---|---|
| 26 Oct | Say Plays, never moves | The product renamed moves to Plays on 24 October; the docs follow the product. |
| 26 Oct | The docs design tomorrow's product | Every section shows today's exact inventory read from the code, and where each item lives tomorrow, tagged Stays, Changes, New or Goes. |
| 26 Oct | Pick one direction at the door | The team picks one of five later; until then each reader picks one and every page is that direction only. |
| 26 Oct | Separate tracks for each reader | Brands, agencies, investors and our team each get their own path through the same pages. |
| 26 Oct | Workflows are documented and specified now | Building them in the product comes later; every template starts off and every run stops for a yes. |
| 26 Oct | A brief is written for the person who ships it | Pick who it is for: your team, an agency, a designer, a media buyer, a creator, a video editor, or our team. |
| 26 Oct | Never name ShopOS on a page | Say our team. The product stays independent of the company that runs it. |
| 26 Oct | The docs cannot drift from the code | A truth check compares the catalogues with the code and stops a publish when they differ. |
| 25 Oct | Five directions in the final audition | Fetch the dog, Buzz the bee, Scoop the raccoon, Ocho the octopus, Seeti the cooker. |
| 25 Oct | One product, 309 surfaces down to 22 | Six addresses: Today, Work, Your store, Settings, a pick, Make it. Every old surface lands in one of them or goes. |
| 25 Oct | Fun and playful, never serious or creepy | Every direction is warm; the character steps out when something goes wrong. |
| 25 Oct | Fonts are part of the brand | Never a default face such as Inter, Poppins, DM Sans, Space Grotesk, Fraunces, Instrument, Manrope or Syne. |
| 25 Oct | Super clean, restrained branding | Few faces, a tight scale, generous space, no clutter. |
| 25 Oct | Versions grow one power at a time | v1 drafts and hands off, v2 posts and schedules, v3 measures, v4 runs ads inside rules. |
| 24 Oct | One version, then Redo it | Never three options at once in the product. |
| 24 Oct | Sell relief, never discounts | Upsells are the payoff a person feels, never a percent off. |
| 23 Oct | Every fix works for every brand | Fix the shared cause and heal saved data; never a one brand patch. |
| 23 Oct | Claims need proof | A health or measured claim needs the study named beside it, or the team's approval in the Brand Book. |
| 16 Oct | Read only, always | The product reads connected accounts and never posts, pauses or moves budget in v1. |

[src: brand-directions/docs2/content/decisions.mjs]

## Tomorrow

Not applicable to a generated document: it is rewritten from its sources on every build.

## How we do it

Generated by `handbook/tools/gen.mjs` on every build. Change the source, never this file. Add a decision by adding a row to decisions.mjs, or by telling Claude "decided: …"; the handbook-update skill adds it.

## Numbers

Not applicable to a generated document: it is rewritten from its sources on every build.

## Open

Not applicable to a generated document: it is rewritten from its sources on every build.