Chapter 9 — Add a Product or Account¶
The doing chapter for adding new products and accounts to the system. By the end you'll have a fully working new product file, a new account with its avatar, and the supporting infrastructure (R2 upload, sales-channel mechanics, version registry entry).
Chapter at a glance¶
flowchart LR
A[Add new<br/>product file] --> B[Add new<br/>account file]
B --> C[Upload avatar<br/>ref to R2]
C --> D[Set up sales<br/>channel mechanics]
D --> E[Register in<br/>version registry]
Apply the structure from Chapter 8 to set up something new.
What you'll learn¶
- How to add a new product (brand doc, product doc, the registry entry)
- How to add a new account (avatar archetype, persona, settings)
- How to upload an avatar reference sheet to R2 and register the URL
- How to set up sales-channel mechanics — TikTok Shop link, ManyChat keyword automation, AI Label Trick implementation
- How to register a new product or account in the version registry
Before this chapter¶
Read Chapter 8 — Products & Accounts. You need to understand the structure before you can extend it.
Sections¶
- Adding a new product — what files to create, what fields to fill
- Adding a new account — archetype, reference sheet, account file
- Uploading the avatar reference to R2 — the Worker proxy mechanics
- Setting up sales channel mechanics — TikTok Shop, ManyChat, Meta Shop, AI Label Trick
- Registering in the version registry — the canonical record
Try this¶
Set up a new account end-to-end. This is the most consequential assignment so far — the result lives in the registry and is referenced by every future workflow for that account.
Steps:
- Decide on the archetype (mother, daughter, naturopath, etc.). Find a single 3-panel reference photo (front / three-quarter / side profile) (Adding a new account)
- Tell Claude: "Add a new account for
<brand>. Archetype is<archetype>. Reference photo is at<path>. Sales channel is<TikTok Shop | Amazon | Meta Shop>." - Claude creates the account file and uploads the reference to R2 (Upload Avatar Ref to R2)
- Set up the sales channel mechanics — Shop link / ManyChat keyword / AI Label Trick as applicable (Setup Sales Channel Mechanics)
- Register the account in
reference/version-registry.jsonso future workflows discover it (Register in Version Registry) - Verify by running a test workflow that targets only this account — confirm the avatar reference is wired in correctly and the sales channel mechanics work end-to-end
If you hit:
- R2 upload fails → check the Worker proxy URL is reachable. See Upload Avatar Ref to R2
- The reference photo crops badly in PatchWork → 3-panel layout matters. Re-read Avatar Archetypes & Reference Sheets
- ManyChat keyword isn't triggering DM responses → see Setup Sales Channel Mechanics. Test in the ManyChat dashboard, not just in-app
- Test workflow doesn't pick up the new account → registry entry is missing or malformed. Confirm by reading the JSON; see Register in Version Registry
When you're ready¶
→ Next: Chapter 10 — Content Research. Now that you have an account set up, you'll often need to research what's working for the niche before building workflows for it.