Answer
Every help article a brand needs in v1, each a plain answer true for today's product, and where Buzz may add one line.
Today
There is no help centre today. What a brand can reach:
| What exists | Detail | Source |
|---|---|---|
| Help row | In the account menu, Help · Email us opens an email to hello@joinsquareup.com with the brand in the subject |
brew/public/live.js:335-339 |
| Privacy and Terms | Short preview pages dated 19 October 2026, with the contact address | brew/legal-pages.js:5-6, 18-48 |
| Delete my data | A sheet that drafts a deletion request and says we delete within 7 days | brew/public/live.js:344-351 |
| Connect sheets | Guided checklists with deep links and copy buttons for each tool | memory brew-real-connectors |
| The demo stores | demo.joinsquareup.com, pointed to from every outsider wall | brew/public/app.js:286-290 |
The facts each article below rests on:
| Fact | Source |
|---|---|
| Sign in is Google only. Only the brand's own email domain, our staff or an invite opens a brand. | brew/public/app.js:409; memory brew-access-rules |
| An invite works for 14 days, for the invited Google account only. | brew/auth.js:78, 190 |
| The read looks at the store's public site, public reviews, rivals' sites and their ads in Meta's public Ad Library, and what AI assistants answer. | brew/legal-pages.js:20-21 |
| The brief waits 15 minutes for Check what we read, then goes on with what was read. | brew/build.js:94 |
| On a first read, the Plays start when someone opens the feed. | brew/confirm-remind.js:84-87; memory brew-feed-open-moves |
| Connected accounts are read only. Keys are stored encrypted. Only the team sees what they show. | brew/legal-pages.js:23 |
| Only an admin connects or disconnects. Teammates can sync. | memory brew-real-connectors |
| A brief to the brand's own team is copied, never sent. A brief to our team is emailed and tracked. | brew/jam-brief.js:361-363 |
| Every jam email can mute the jam, switch to tags only, or turn emails off. | brew/jam-mail.js:29, 91-97 |
| Plays, cards and drafts are suggestions. Every number shows its source. Check before you spend or publish. | brew/legal-pages.js:41-42 |
| The preview is free and can change or stop. | brew/legal-pages.js:39-40 |
| Pricing is parked until after the design partnership. | memory brew-pricing-parked |
Tomorrow
| Version | Tag | Item |
|---|---|---|
| v1 | New | A help centre of the thirteen articles below, opened from Help in the account menu, before the email link. |
| v1 | New | Each answer is plain, names the screen and the button, and is true for the version the brand is on. |
| v1 | New | Buzz may add one line at the top of an article, from the column below. Articles on access, data, money and our team carry none. |
| v1 | Changes | Help stays one tap from a person: every article ends with Email us. |
| v2 | Changes | Articles on posting change when v2 adds posting with a yes on every post. |
The articles
| # | Article | Plain answer | Buzz's line |
|---|---|---|---|
| 1 | What it does and what it reads | Add your website and sign in with your work Google account. It reads your public site and reviews, your rivals' sites and public ads, and what AI assistants say about your category, then writes your Plays and a feed of ideas. Nothing is posted from it. | “Buzzing round your store. About 3 to 4 minutes.”, once the read time is measured |
| 2 | Who can open your brand | Only people with an email at your own domain, people you invite, and our team. A personal email sees a page that points to the demo stores. An invite link works for 14 days. | None. Access stays plain. |
| 3 | Check what we read | After the read, check the facts: fix anything wrong, star your hero products, confirm. If nobody checks within 15 minutes, the brief is written from what was read. You get a reminder after 3 hours and after a day. | “I'm not sure of this number. Confirm it before you use it.” |
| 4 | When your Plays arrive | On a first read your Plays start the moment you open your feed, and land one by one. You get an email when the first ones are in and when all are in. | “Monday. Five best blooms for your store, drafted.”, once the Monday drop ships |
| 5 | Connecting your accounts | Your admin connects Shopify, Google Analytics, Meta, Klaviyo, Judge.me and Slack from Connect your tools. Every connection is read only. Your feed then uses your own numbers. | None. Access stays plain. |
| 6 | Your team | Invite people from Invite your team. Anyone who signs in with your company email joins on their own, and your admins get an email. | None |
| 7 | Making it in a jam | Open a card, make it, and ask for changes in the chat. Every version is kept. | “Fresh batch. The old one is still in the jar.” |
| 8 | Sharing the brief | Share the brief copies it with a read only link for your own team, and nothing is sent. You can also download a PDF or open an email draft with the files. | “Brief copied. Paste it to them. Pollen passed.” |
| 9 | Sending a brief to our team | Pick our team in Send to. We get the brief and files by email, and you see where it stands in the top bar: received, in progress, needs info or delivered. | None. A person handles it. |
| 10 | Fewer emails | Every jam email has Mute this jam, Only when I'm tagged and a link to turn emails off. The weekly email has its own link at the bottom. | None |
| 11 | Your data and deleting it | Your read, Plays, jams and connected numbers are seen only by your team. To delete, use Delete my data in the account menu. We delete within 7 days and reply when it is done. | None. Privacy stays plain. |
| 12 | Limits and price | Reads are limited while we build: one new brand an hour from one network, and a daily reading budget. The preview is free. Pricing comes later, and you hear before anything changes. | “The hive is full this week. Reads are capped while we build v0. Ask us for one.” on the limit only. None on price. |
| 13 | When something breaks | The screen says what happened, what is safe and one way out. If it keeps happening, use Help in the account menu and a person replies. | “Oops, I bumped the window. Your work is safe. Try again.” |
Buzz's rules for these lines
- Fact first, buzz second. One joke per line at most.
- Never more than two sentences in the product.
- Bee puns at most once per screen, and never in errors about money, privacy or data.
- Turn the character fully off for errors on our side, money, privacy, apologies and anything a person must sign.
brand-directions/docs2/data/dirs.json; brand-directions/bee/system.md
Lines Buzz never says, in any of these:
- “I posted it for you.”
- “Scheduled for 9am.”
- “Your sales went up after my picks.”
- “You missed a week.”
- “Buzz off.”
brand-directions/docs2/data/dirs.json
How we do it
Write each answer from the code at brew origin/main, never from a plan. If the code changes, the article changes in the same week.
Keep each answer to what the screen says and which button to press.
Add Buzz's line only from the approved lines or the words table, and only where the column allows it.
Check every answer against the facts table in Today before it ships.
cd /Users/param/Documents/ChatGPT/handbook && node check.mjs
Numbers
| Metric | Definition | Where measured | State |
|---|---|---|---|
| Help emails | Emails to hello@ that came from the Help row, by brand per week | hello@ inbox, subject starts with Brew help | Proposed |
| Article views | Opens per article per week | to be added with the help centre | Proposed |
| Answered by an article | Help emails whose answer was already an article | hello@ inbox, labelled | Proposed |
Open
- Where does the help centre live? Proposal: inside the product, from Help in the account menu, as one page with thirteen sections.
- Is the 7 day deletion promise ours to keep on production? Proposal: yes. The deletion tool,
db/delete-brand.mjs, is on origin/main and reaches production with the next promote; until then an engineer does it by hand within 7 days. - Do we publish the read limits by number? Proposal: say they exist and that a person can lift them, without numbers that can change.
- The read line promises 3 to 4 minutes. Proposal: measure ten first reads on production before it ships.