{
 "id": "1.13",
 "title": "Decisions log",
 "department": "Company and strategy",
 "department_slug": "company-and-strategy",
 "direction": null,
 "branded": false,
 "status": "generated",
 "owner": "Param",
 "last_verified": "2026-10-26",
 "holds": "Every call with its date and why, never deleted",
 "urls": {
  "html": "https://handbook.joinsquareup.com/company-and-strategy/decisions-log",
  "markdown": "https://handbook.joinsquareup.com/company-and-strategy/decisions-log.md",
  "json": "https://handbook.joinsquareup.com/company-and-strategy/decisions-log.json"
 },
 "other_directions": [],
 "tldr": {
  "headline": "Every call we made, newest first, never deleted",
  "points": [
   {
    "icon": "flag",
    "text": "26 Oct: the word is Plays, and we never name ShopOS on a page."
   },
   {
    "icon": "rocket",
    "text": "Versions grow one power at a time: drafts, posting, results, ads."
   },
   {
    "icon": "check",
    "text": "Every fix works for every brand, and read only stays on for v1."
   },
   {
    "icon": "heart",
    "text": "One version then Redo it; sell relief, never discounts."
   },
   {
    "icon": "gear",
    "text": "Generated by gen.mjs on every build; add a row, never edit the file."
   }
  ],
  "stat": {
   "value": "22",
   "label": "surfaces after the cut"
  },
  "decide": null,
  "mood": "solid"
 },
 "sources": [
  "brand-directions/docs2/content/decisions.mjs"
 ],
 "open_questions": [],
 "parts": {
  "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 |\n|---|---|---|\n| 26 Oct | Say Plays, never moves | The product renamed moves to Plays on 24 October; the docs follow the product. |\n| 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. |\n| 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. |\n| 26 Oct | Separate tracks for each reader | Brands, agencies, investors and our team each get their own path through the same pages. |\n| 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. |\n| 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. |\n| 26 Oct | Never name ShopOS on a page | Say our team. The product stays independent of the company that runs it. |\n| 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. |\n| 25 Oct | Five directions in the final audition | Fetch the dog, Buzz the bee, Scoop the raccoon, Ocho the octopus, Seeti the cooker. |\n| 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. |\n| 25 Oct | Fun and playful, never serious or creepy | Every direction is warm; the character steps out when something goes wrong. |\n| 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. |\n| 25 Oct | Super clean, restrained branding | Few faces, a tight scale, generous space, no clutter. |\n| 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. |\n| 24 Oct | One version, then Redo it | Never three options at once in the product. |\n| 24 Oct | Sell relief, never discounts | Upsells are the payoff a person feels, never a percent off. |\n| 23 Oct | Every fix works for every brand | Fix the shared cause and heal saved data; never a one brand patch. |\n| 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. |\n| 16 Oct | Read only, always | The product reads connected accounts and never posts, pauses or moves budget in v1. |\n\n[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."
 }
}