Ecommerce guide
How to build a brand OS: a step-by-step guide
Connect your data, write the context and skills AI needs, then put agents and automations to work across the team.

What is a brand OS, and why do ecommerce brands need one?
A brand OS is a shared base of data, knowledge, and collaboration that every person and AI agent in an ecommerce company works from, so AI gives the whole team consistent answers instead of helping one person at a time.
This guide is based on “Building a Brand OS,” a talk Fletcher Richman, co-founder and CEO of type.com, gave to an EcommerceFuel think tank of seven- and eight-figure brand owners on September 23, 2026. Every figure is a slide from his deck. Watch the talk
Most ecommerce brands already use AI. Marketing has ChatGPT open all day, someone in ops built a clever Claude project, and finance tested a reporting prompt. The company as a whole still isn't getting much out of it.
Fletcher has spent the past year talking with brands of every size, from Bombas, Coach, and True Classic to one- and two-person startups. He keeps hearing the same problem. Each person uses AI in their own way, with their own data and context. Ask for yesterday's revenue and you get one number on Monday and a different one on Tuesday. And the strongest AI users build up methods that nobody else on the team can reuse.
A brand OS fixes this. It gives the whole company one place for its data, one shared understanding of how the business works, and one set of agents and automations everyone can use.
What are the three layers of a brand OS?
A brand OS has three layers, built from the bottom up: data (what's happening), knowledge (how your business works), and collaboration (how the team turns the first two into action).
Every brand Fletcher has worked with ended up with the same three layers. Skip the data layer and AI guesses. Skip the knowledge layer and AI sounds like it has never heard of your company. Skip the collaboration layer and all of it stays stuck on one person's laptop.
The 11 steps below follow the talk in order, plus what Fletcher recommended when attendees asked questions.
| Layer | Question it answers | Steps |
|---|---|---|
| Data | What's happening in the business? | 1–2 |
| Knowledge | What does the system understand about us? | 3–6 |
| Collaboration | How do we turn it into action? | 7–11 |
Step 1: Which data sources should you connect first?
Connect commerce (Shopify, Amazon), marketing (Meta, Google, Klaviyo), operations (your 3PL and inventory), and wholesale (your ERP) first, then agree on definitions so every source reports revenue the same way.
AI with no data is guessing. For a typical direct-to-consumer brand, four areas matter most. You'll have other sources too, but almost every question your team asks AI depends on these.
Connecting them is only half the work. Agree on definitions and reconcile the numbers, so that “revenue” means the same thing no matter which source the AI checks.

| Area | Typical sources |
|---|---|
| Commerce | Shopify, Amazon |
| Marketing | Meta, Google, Klaviyo |
| Operations | Your 3PL (ShipBob, ShipMonk) and inventory |
| Wholesale | Your ERP (NetSuite, Dynamics 365) |
Step 2: Do you need a data warehouse, and which one?
If you're under $5M in revenue and Shopify-only, you probably don't need a data warehouse. Over $5M or multichannel, evaluate one: Polar Analytics if you want it managed, BigQuery as the default, or Snowflake if your team already uses it.
Before AI, a data warehouse was nice to have. Now it's close to essential for most brands. When data is spread across a dozen tools, any AI your team uses has to pull a bit from each one, and nothing is the single source of truth.
Fletcher's rule of thumb (type.com doesn't sell a data warehouse): under $5M in revenue and Shopify-only, Shopify can be your source of truth for now. Over $5M, or selling on more than one channel, evaluate a shared data platform.
He recommends three: Polar Analytics is a managed, Shopify-led warehouse and the lowest-touch option for teams with few engineers. Google BigQuery is his default: it works well out of the box, you own all your data, and most of the seven- and eight-figure brands type.com works with use it. Snowflake is a strong choice if it's already in your stack or your engineers prefer it.
An attendee asked whether plain Postgres or MySQL would do. It can, at a certain scale. Warehouses are built to take messy data from many sources and run lots of queries on it, so the answer depends on how many rows you have and how varied they are.
| Your situation | Recommendation |
|---|---|
| Under $5M, Shopify-only | You probably don't need one yet |
| $5M+ or multichannel, few engineers | Polar Analytics (managed) |
| $5M+ or multichannel, default | Google BigQuery (own your warehouse) |
| Snowflake already in your stack | Snowflake |
Step 3: Which context files should you write first?
Start the knowledge layer with four short files you write yourself: company.md (what you sell), customer.md (who buys and why), offer.md (what you promise), and voice.md (how you sound). Review them monthly.
The knowledge layer didn't exist before AI. It answers one question: what does the system understand about your business? Fletcher's analogy is that a fresh chat with Claude or ChatGPT is a PhD-level hire who knows nothing about your company. The knowledge layer is the onboarding.
Start with static context, the part of your business that changes about once a month or once a quarter. Three rules apply. Write the files yourself; brainstorm with AI if you like, but the CEO or COO should be confident every line is right. Keep them short, because they load into a lot of AI requests. And review them monthly.
According to Fletcher, these four files make a model feel less like someone who's never heard of your company and more like someone who has been onboarded for four to eight weeks.

Example company.md outline created for this guide
# company.md ## What we sell One paragraph. Products, price range, channels (DTC, Amazon, wholesale). ## How we make money Main revenue drivers, typical AOV, contribution margin targets. ## Where we are now Annual revenue band, team size, the 2–3 priorities for this quarter. ## What we will not do Discounting rules, channels we avoid, claims we never make.
| File | What it covers |
|---|---|
| company.md | What you sell |
| customer.md | Who buys and why |
| offer.md | What you promise |
| voice.md | How you sound |
“Think about these as the four documents that are your anti-slop parameters that stop the future outputs from feeling like they're just generic slop.”
— Fletcher Richman, co-founder and CEO of type.com
Step 4: How do you keep changing context current?
Dump everything that changes daily (emails, Slack messages, meeting notes, decisions) into a /raw folder without organizing it, then have an agent turn it into a searchable /wiki every week.
Dynamic context changes every day. The wiki lets future AI requests skip the raw pile: ask “what did we decide in yesterday's launch meeting?” and the agent goes through a tidy index instead of every meeting ever recorded. That saves tokens and makes answers faster. If the four context files are a new hire's first month, the wiki is their next two years.
Keep both folders somewhere in the cloud that the whole team and their AI tools can reach, not on someone's laptop. Fletcher sees four options: a type.com Space, a private GitHub repo for more technical teams, Notion, or Google Drive, which he finds messy for this job.
For permissions, start with public information only: shared inboxes, public Slack channels, shared Drive folders, and public meeting notes. Leave personal email and private notes out of the first version. Once that works, give sensitive teams such as finance their own /raw and /wiki with separate access.

- 1
Create /raw and sync it daily or hourly
Pipe in meeting notes (for example from Granola), shared inbox emails, public Slack channels, and document changes. Don't organize anything. Raw is append-only, so it builds a full history without extra version control.
- 2
Create /wiki and schedule a weekly agent
The agent reads what's new in /raw and updates an indexed wiki that future requests can search quickly.
- 3
Split out private teams later
Once the shared version works, add separate /raw and /wiki folders with their own permissions for teams like finance.
Example wiki instructions created for this guide
Every Monday, read everything added to /raw since your last run. Update /wiki so a future agent can find any fact in two hops: - /wiki/index.md lists every page with a one-line summary. - One page per topic (customers, products, campaigns, suppliers, decisions). - Record decisions with the date, owner, and a link to the source file in /raw. - When new information contradicts a page, update the page and note what changed. Do not delete anything from /raw.
Step 6: How do you keep shared skills trustworthy?
Turn your best people's methods into shared skills, and give every skill an owner, version history, usage metrics, and edit permissions.
After the first four, keep adding skills. The goal is that what your best people know how to do stops living only in their heads and becomes something the whole team can run.
Governance matters more than it sounds. An experimental skill can be open to everyone. Your ROAS definition shouldn't be, or the company ends up reporting different numbers again.
- An owner, so someone is accountable for changes.
- Version history, so you can see what changed and roll it back.
- Usage metrics, so you know which skills people actually use.
- Edit permissions, so critical definitions only change on purpose.
Step 7: What goes in the collaboration layer?
The collaboration layer has four parts: automations that run on a schedule, agents set up per department, apps such as dashboards and tools, and shared memory of decisions and lessons.
Automations run on a schedule and post wherever your team works. Apps are dashboards and custom tools built for your business. Shared memory captures decisions and lessons as work happens; Fletcher says it “kind of creates itself” once the other three are running.
Fletcher defines an agent as one department (marketing, finance, operations) with access to that department's data, available wherever the team works: Slack, email, or Teams. Pointing an agent at a department works better than giving it a persona.
Wherever you build these, they can't live on one person's machine. Some brands with engineering teams build their own internal agent platform. Others use a shared AI workspace such as type.com.
Step 8: What's the best first automation?
Start with a daily performance report: every morning, post yesterday's sales against plan, the last seven days, and what's working to the channel or inbox your whole team already uses.
Starting with agents across the whole company is overwhelming. Across type.com customers and the other brands Fletcher has talked to, three first workflows come up most often and pay off fastest. This is the first, and it's an automation.
It sounds simple, but for most brands it's the first real aha moment. It runs on your data layer and revenue skills, so the number is accurate, and the whole team sees the same thing every day. Run it daily for the people closest to the numbers and weekly, on Monday, for everyone else.

Example daily performance automation
Every weekday at 8:00 AM, post to #daily-performance. Use the Revenue Definitions and Revenue Reporting skills. 1. Yesterday's sales vs. plan, as a number and a percentage. 2. The last 7 days vs. plan and vs. the same 7 days last year. 3. Revenue by channel (Shopify, Amazon, wholesale). 4. One line on what changed most and the likely reason. Run the Revenue Reconciliation skill first. If any source is stale, say so at the top.
Step 9: How should you hand paid media to an AI agent?
Give a paid media agent a daily action list across Meta, Google, and TikTok. Start with recommendations a person approves, then let it act within set limits once its suggestions are consistently good.
The second first workflow is an agent. Paid media generates more data than one person can review, and Fletcher says models are surprisingly good at finding ideas a human would miss.
- 1
Start with Meta
Setup is a hassle: you create a custom Meta developer app and grant exactly the permissions you want. Start with read access for recommendations. Before enabling changes, set approval rules and spending limits in the agent workflow as well as the required API permissions.
- 2
Make the daily review a skill
A skill like “review my Meta ads and recommend three changes” runs every day. If you don't like the output, edit the skill instead of re-prompting.
- 3
Keep a person on every change at first
The agent recommends; a person decides and makes each change. Do this for several weeks, or longer if your spend is high.
- 4
Hand over control gradually
When you've approved its recommendations as-is several days in a row, let it pause ads and move budget on its own within the limits you set.
“You'll get fatigue as the human team because the AI is relentless. It's every day, it's going to have recommendations and things it wants to do.”
— Fletcher Richman, co-founder and CEO of type.com
Step 10: How do you use AI for landing pages and PDPs?
Build landing pages and product pages with AI in a shared thread, and have the agent publish Shopify Liquid templates so every page uses your real products and inventory.
The third first workflow is an app. AI is very good at writing code, so you can build a landing page for every ad variation, launch, or product test instead of a handful a quarter.
The brands doing this best have their agent write Shopify Liquid templates and push them straight to the store, so pages map to real product and inventory data. Some type.com customers now run hundreds or thousands of pages, each matched to the creative from their paid media agent. The details depend on your stack, including whether you're headless.
Step 11: How do you choose what to build next?
Pick each next AI project by payoff: revenue upside times contribution margin, plus usable time savings, minus the cost to build and run it. Start where there's a real bottleneck, enough volume, and a measurable result.
After the first workflows, you could build almost anything: inventory tools, ad generation apps, customer service agents. Brands often get stuck choosing. Pick by payoff, then go from baseline to small test to measure to scale.
If you're not sure where the opportunities are, point an AI at your Slack and email history and ask where the biggest revenue upside is. Often the problem isn't what AI can do. It's knowing what's possible.
How do you get the whole team using the brand OS?
Put the shared layer where everyone can use it without learning new tools, let power users keep working from Claude, and make comfort with AI part of how you hire.
In the Q&A, one attendee asked what to do about an employee who refuses to use AI at all. Fletcher passed on advice from a recent founder roundtable: going forward, make excitement about and familiarity with these tools part of the interview process.
A shared brand OS also lowers the bar for everyone else. People who never open an AI tool still get the daily report in Slack or email, and they can ask the department agent a question where they already work.
Power users don't have to give anything up. Another attendee asked whether this replaces Claude. It doesn't: the knowledge and skills stay shared, and people keep working from Claude. With type.com, the MCP server and CLI let someone build an automation from Claude that the whole team can then use. A one-off personal automation can stay in your own Claude; a shared one, like inventory alerts, belongs where everyone can see it.
And if your whole team already lives in GitHub? Claude plus GitHub can carry the context. You still need to choose how to run the automations, agents, and apps; a repository alone does not provide the shared operating layer.
What's the short version of building a brand OS?
Build the three layers in order (data, then knowledge, then collaboration), then pick one workflow, give it an owner, and measure the result.
Each layer has a clear finish line. Don't move on until the one below it works.
| Layer | Build this | Done when |
|---|---|---|
| Data | Four core sources, plus a warehouse if you're over $5M or multichannel | Everyone gets the same revenue number |
| Knowledge | Four context files, /raw and /wiki, and four revenue and marketing skills with owners | A new AI chat already knows your business |
| Collaboration | One automation, one agent, and one app, shared across the team | The team acts on AI output every day |
Frequently asked questions
Do I need a data warehouse to build a brand OS?
Not if you're under about $5M in revenue and sell only on Shopify. Over $5M, or with more than one sales channel, evaluate one. BigQuery is Fletcher Richman's default recommendation, Polar Analytics is the lowest-touch option, and Snowflake makes sense if your team already uses it.
Should AI write my company, customer, offer, and voice files?
Use AI to brainstorm, but write the final versions yourself. Everything the AI produces builds on these four files, so the CEO or COO should be confident they're right. Keep them short and review them monthly.
Where should the /raw and /wiki folders live?
In a cloud location the whole team and their AI tools can reach: a type.com Space, a private GitHub repo, Notion, or Google Drive. Never keep them on one person's laptop.
Will AI give the same revenue answer every time?
It will if your skills run code (SQL or Python) against a shared data source instead of relying on instructions alone. Clean data is still a prerequisite. Skills won't fix messy source data.
How much autonomy should a paid media agent have?
None at first. Begin with daily recommendations that a person carries out. Once you're approving them unchanged several days in a row, let the agent pause ads and move budget within explicit approval rules and spending limits. Meta app permissions determine API access; your workflow must enforce the operating limits.
What if someone on the team refuses to use AI?
A shared brand OS lowers the bar, because people get answers in Slack or email without learning new tools. For future roles, make comfort with AI tools part of the interview process.

