From the Agency Builders Community

The client file system that lets AI run your accounts.

Claude Code is only as good as the files you give it. Here is the exact folder system we use at Business Builders so every client engagement is readable by our team and our AI, from kickoff to reporting.

The Core Idea

Your client folders should read like an operating manual.

When a teammate or a Claude session opens a client folder, it should already know where everything lives. No hunting. No tribal knowledge. Two decisions make that possible.

01

One standard structure for every client

Same folders, same names, same places. The value comes from consistency. One weird client folder breaks the pattern for the team and the AI.

02

Plain markdown as the source of truth

Markdown is what an LLM reads best. Facts live in .md files. Long prose can live in Google Docs, but the substrate the AI works from stays markdown.

How It's Built

Three layers, from your machine to your team.

Layer 1

The projects directory

Everything lives under one root folder, organized by company rather than by file type. A CLAUDE.md file at the root explains the whole structure to Claude: what each folder is, how projects are named, where new work goes.

Claude reads it automatically at the start of every session. It is the employee handbook the AI actually reads.

~/projects/ ├── your-agency/ │ ├── _clients/ every engagement │ ├── _assets/ brand exports │ └── internal/ agency projects ├── other-ventures/ └── _system/ backups, skills CLAUDE.md the map Claude reads
Layer 2

One skeleton per client

Every client gets the same folder skeleton. The CLAUDE.md inside records what Claude needs to do good work: tier, retainer, current focus, who is on the account, and any hard rules.

Start a session in that folder and Claude is briefed before you type a word. A reusable skill scaffolds the whole thing from a template with placeholder tokens, so a new client folder takes one command.

_clients/client-name/ ├── CLAUDE.md engagement manual ├── messaging/ brandscript ├── design-system/ visual system ├── blueprint/ kickoff strategy ├── brand-voice/ voice + tone ├── plays/ active campaigns ├── reports/ monthly + quarterly └── assets/ photo, video, source
Layer 3

The Client OS on shared drive

The team-facing version lives in a Google Shared Drive, one folder per client, mounted locally through Drive for Desktop. Claude writes files with normal file tools and Drive syncs them up. No API work needed.

The drive also holds a blank template, a fully filled example client, a registry indexing every client, and an AGENTS.md telling any LLM or teammate how to use the library.

Shared Drive/ ├── Client OS System/ │ ├── AGENTS.md rules for any LLM │ ├── REGISTRY.md index of clients │ ├── _TEMPLATE/ blank skeleton │ └── EXAMPLE/ what done looks like └── one folder per client...
The Discipline

Four rules keep it from rotting.

Single source of truth

Every fact lives in one file. Edit it there, nowhere else. Duplicated facts drift, and drifted facts end up in client deliverables.

Markdown for facts

Never convert the markdown to Docs. Google Docs is fine for long prose, but the files the AI reasons from stay plain markdown.

Flag unverified numbers

Any stat that has not been checked gets a "(verify before publishing)" tag, so it never ships to a client by accident.

Visible freshness

Every file carries a small header with owner, last updated date, and status. Stale files announce themselves.

Why It Pays Off

What changes when the system is in place.

Any team member, or any Claude session, can pick up any client cold. The folder is the briefing.

Onboarding a new client takes minutes. The scaffold skill builds the documented folder in one command.

Deliverables get better. Claude always has the brandscript, voice rules, and strategy in reach.

The system compounds. Every report, play, and decision gets filed where the next session will find it.

Copy This

Where to start in your agency.

1

Put all client work under one root folder

Then write a CLAUDE.md at the root that explains the structure, the naming rules, and where new work belongs.

2

Build a template client folder

Include a CLAUDE.md inside it with placeholders for tier, retainer, team, and current focus.

3

Turn the template into a Claude Code skill

Setup becomes one command: copy the template, answer a few onboarding questions, and every placeholder gets filled.

4

Keep facts in markdown and enforce one source of truth

The tooling is simple. The discipline is the product.

Build the agency that builds your life.

Agency Builders is the private community where agency owners trade real systems like this one, operator to operator.

Join the Community