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.

The brand OS guide cover: three stacked layers. Data connects Shopify, Meta, and Google into shared data. Knowledge holds company.md, customer.md, offer.md, voice.md, and revenue skills. Collaboration shows a #daily-performance report with $48k sales yesterday against a $50k plan, down 4%.

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.

The three layers of a brand OS and the steps for each.
LayerQuestion it answersSteps
DataWhat's happening in the business?1–2
KnowledgeWhat does the system understand about us?3–6
CollaborationHow 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.

Slide titled 'Give AI access to the business'. Commerce (Shopify, Amazon), Marketing (Meta, Google, Klaviyo), Operations (ShipBob, ShipMonk), and Wholesale (NetSuite, Dynamics 365) feed into Shared business data, which produces Answers your team can use. Footer: Connect the sources, agree on definitions, reconcile the numbers.
Four source areas feed one shared data layer. The goal is answers the whole team can trust, not just connections.
The four core data areas for a DTC brand.
AreaTypical sources
CommerceShopify, Amazon
MarketingMeta, Google, Klaviyo
OperationsYour 3PL (ShipBob, ShipMonk) and inventory
WholesaleYour 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.

When you need a data warehouse, and which one to pick.
Your situationRecommendation
Under $5M, Shopify-onlyYou probably don't need one yet
$5M+ or multichannel, few engineersPolar Analytics (managed)
$5M+ or multichannel, defaultGoogle BigQuery (own your warehouse)
Snowflake already in your stackSnowflake

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.

Slide titled 'Start with four context files': company.md, what you sell; customer.md, who buys and why; offer.md, what you promise; voice.md, how you sound. A label underneath reads 'Update monthly'.
Four files turn a blank-slate model into one that already knows your business. Keep them short and update them monthly.

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.

The four context files.
FileWhat it covers
company.mdWhat you sell
customer.mdWho buys and why
offer.mdWhat you promise
voice.mdHow 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.

Slide titled 'Keep the changing context current': /raw (emails, notes, decisions) flows to a Weekly update where an agent reads and organizes it, then to /wiki (searchable business context). A loop notes: Use the current wiki to build on what you already know.
Raw is the full history. The wiki is the organized index future AI requests actually read.
  1. 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. 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. 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 5: Which shared skills should you build first?

Instead of a costly semantic layer, build four shared skills that define and report your numbers: Revenue Definitions, Revenue Reporting, Marketing Measurement, and Revenue Reconciliation.

Some large brands build a semantic layer, a custom set of definitions on top of the warehouse. Fletcher thinks that's overkill unless you're a nine-figure brand with plenty of resources. Shared skills do the same job for a fraction of the cost.

A skill is a set of instructions, and often code, that an agent follows every time someone asks a certain kind of question. Start with revenue, because “how are we doing?” is the first question everyone wants answered reliably. If you sell on only one channel, skills 01 and 02 can be one skill.

Unlike the context files, you don't need to write skills by hand. Work with an agent to draft them.

Will a skill give the same answer every time? It will if it runs code. Because step 1 gave the agent a data source, a good skill doesn't just read instructions; it runs SQL or a Python script against your warehouse. Ask for “revenue for the last seven days in Europe” and everyone gets the same number. Fletcher's caveat: skills won't fix messy data, and brands with years of history and many revenue sources may need cleanup first.

Two slides combined. 'Two skills for consistent revenue reporting': 01 Revenue Definitions sets the rules for sales, discounts, refunds, tax, shipping, dates, and currency; 02 Revenue Reporting combines Shopify, Amazon, and wholesale sales into one report without double counting. Below: 03 Marketing Measurement calculates ROAS, blended marketing efficiency, and new-customer CAC using agreed attribution rules; 04 Revenue Reconciliation checks source totals and flags stale data, duplicates, and unexplained differences before publishing.
The four starter skills, each with one defined output. Together they make “how are we doing?” answerable by anyone.
Four starter skills for consistent numbers.
SkillWhat it doesOutput
Revenue DefinitionsSets the rules for sales, discounts, refunds, tax, shipping, dates, and currencyOne agreed set of revenue rules
Revenue ReportingCombines Shopify, Amazon, and wholesale sales without double countingRevenue by channel plus a total
Marketing MeasurementCalculates ROAS, blended marketing efficiency, and new-customer CAC using your attribution rulesConsistent marketing metrics
Revenue ReconciliationChecks source totals and flags stale data, duplicates, and unexplained gaps before publishingA checked report with flagged issues

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.

Slide titled 'Yesterday vs. plan, every morning': an illustrative #daily-performance report showing $48k sales yesterday, $50k plan, and −4% vs. plan, with the note 'Sales missed plan, but grew 8% vs. the same day last week.'
Illustrative numbers from the deck. The report adds context, like growth against the same day last week, not just a total.

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. 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. 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. 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. 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.

Brand OS checklist.
LayerBuild thisDone when
DataFour core sources, plus a warehouse if you're over $5M or multichannelEveryone gets the same revenue number
KnowledgeFour context files, /raw and /wiki, and four revenue and marketing skills with ownersA new AI chat already knows your business
CollaborationOne automation, one agent, and one app, shared across the teamThe 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.