Archive for month: June, 2026

Every SEO agency has a hidden context tax. It shows up when a strategist, content lead, or analyst opens Claude and starts rebuilding all the dos and don’ts for that particular account from memory: the brand voice, the keyword cluster killed last quarter, the CMS limitation, the founder’s rejected angle, the competitor the client doesn’t want mentioned.

That’s the part of AI adoption we’re still underestimating. LLMs can help with specific SEO tasks, but the problem with unleashing AI on more complex work is providing enough account context to make it useful without creating more review work.

One solution is a per-client memory system called a “client brain.” It gives account context a place to live, allowing AI to support the work without treating every task like it’s the first day on the account.

Context is the problem

Context is essential for any worker. A senior SEO account lead onboards human teammates onto client accounts by sharing the strategy, history, politics, preferences, constraints, client language, technical limitations, and all the “don’t do that again” lessons that never quite make it into the brief.

LLMs have inherited that same agency problem. The difference is that AI hits it every time it’s asked to support the work without knowing the account.

A lot of the AI conversation in SEO right now is about connecting data sources. Load GSC, GA4, Ads, crawl data, rank tracking, and maybe CRM data into one place, so that we can finally “chat” with the data.

That’s genuinely useful, especially with live alerts. But for agencies, analysis is just one part of the job. AI also needs account context to summarize a technical audit without recommending a fix the dev team already rejected or to write a brief that sounds like the client and fits the strategy.

That kind of work depends on institutional memory: the account knowledge that builds up after months of working with a client and its stakeholders.

Your customers search everywhere. Make sure your brand shows up.

The SEO toolkit you know, plus the AI visibility data you need.

Start Free Trial

Get started with

A client brain is the solution

A client brain gives that institutional memory a shared home. The team updates it as decisions are made, feedback comes in, and the account evolves. This isn’t a replacement for human judgment. It’s infrastructure that helps that judgment travel across workflows.

In an agency world, SEO work rarely belongs to one person. The strategist sets direction, the content lead builds the brief, the writer drafts, the analyst checks performance, and the technical SEO reviews implementation.

When context stays in people’s heads, every handoff creates drift. When it’s shared, the work stays aligned. A strategist ramps faster, a writer misses fewer client preferences, and the team spends less time re-explaining the account.

What a client brain is

A client brain is a structured, per-client knowledge base that AI reads before it starts the work. Think of it as the institutional memory of an SEO account, written in a way the machine can use.

Not all client knowledge behaves the same way. Some knowledge is stable: the brand, audience, positioning, voice, product, category, and lines the client doesn’t want to cross. Some knowledge is active: decisions, experiments, objections, failed angles, technical blockers, and lessons from client feedback.

Those two types of knowledge need different homes. A client brain splits them into two layers: the soul and the memory.

• The soul is static, identity-level knowledge: Who the brand is, how they speak, who they serve, what they sell, and what “good” sounds like for them
• The memory is dynamic, experience-level knowledge: What the team tried, what worked, what failed, what the client rejected, and what changed during the campaign

This split keeps the brain usable. If everything goes into one big file, brand principles get buried under meeting notes, and old keyword decisions start looking like the current strategy.

The technical anatomy of a brain

A client brain doesn’t need to be a complicated system. It is built as a simple folder of plain-text Markdown files. You don’t need special software, a database, or a custom interface.

Building core logic of the soul

To get started, go into your existing client project folder and create a sub-folder named brain, then create one more folder inside that named soul. This folder path (brain/soul/) is where the core logic of the system lives. It consists of five files, each doing one specific job:

brain/soul/
├── company-profile.md
├── style-guide.md
├── audience.md
├── keyword-map.md
└── never-do.md

company-profile.md 

This is the operating version of the client, not the polished marketing version. Who is this client? What do they really sell? Who do they compete with? Where do they win? Where are they not trying to play?

Six honest sentences usually beat a six-page deck because the AI doesn’t need the full brand story. It needs enough context to avoid bad adjacent decisions.

A real example, anonymized:

• “[Client] is a DTC Japanese-style kitchen knife brand selling chef knives, paring knives, and care accessories. They serve home cooks who value craftsmanship over price, with an average order value around $180. Their differentiator is free in-house sharpening for life. They compete with Made In and Misen on the tier just below Shun and Global. They don’t sell to commercial kitchens or restaurant supply, those have separate procurement cycles. Their highest-converting traffic comes from long-form reviews and YouTube cooking channels, not paid social.”

That’s enough information for AI to make better SEO choices. It knows not to chase restaurant-supply keywords, not to position the brand as the cheap alternative to Shun, and to weight content toward reviews, comparisons, and care guides.

The point isn’t to sound impressive. The point is to be true.

style-guide.md 

This file is where most teams accidentally write something useless. “Warm but professional” doesn’t help AI much. Neither does “expert but accessible.” What works is concrete instruction: one paragraph on tone, a few examples that pass, and a few that fail.

audience.md 

The audience file is where the team stops writing for demographics and starts writing for people. “Small business owners aged 35 to 55” is a targeting box, not an audience. Useful audience context captures worries, objections, misconceptions, language, and what earns trust.

keyword-map.md 

You do not need to create a 500-row export from your keyword tool. Instead, capture how the brand thinks about the category: primary terms we own, secondary terms we want, competitor-owned terms we approach carefully, and terms we don’t want to touch.

never-do.md 

This is the file I wish I’d had years ago. It’s the list of things AI should never propose, never write, and never recommend.

• Some are brand-level: “Never describe the client as an industry leader.”
• Some are operational: “Don’t suggest content that requires legal approval unless the account lead confirms it first.”
• Some are strategic: “Don’t recommend State X landing pages. The client doesn’t serve that state yet.”

Every “we already discussed this and decided no” should eventually end up here. AI is very good at confidently resurfacing dead ideas. This file stops the team from having the same conversation every month.

Memory captures decisions, patterns, and logs

Memory lives in brain/memory/. It’s organized differently from the soul because it comes from doing the work.

brain/memory/
├── decisions/    — choices made and why
├── patterns/     — things that worked or didn’t, by task type
└── log/          — chronological notes by date

The decisions/ folder stores choices made and why. A memory entry looks like this:

# 2026-04-21 — Content brief for Q2 implant campaign

Decided NOT to target "dental implants near me" as the primary keyword.
Reason: Client doesn't accept Medicaid; the highest-volume "near me" searches in our markets skew Medicaid.
Pivot to "premium implants [city]" framing.
Source: Client strategy call notes, 2026-04-21.
Tags: client:[name], task:content_brief, type:decision

The reason matters more than the decision. If AI only knows “don’t target dental implants near me,” it may avoid that keyword forever, even when the context changes. If it knows why, it can make better adjacent decisions later.

The patterns/ folder 

This stores what the team learns across repeatable work. After enough AI visibility audits, for example, our system started building a pattern file around where those audits tend to break: changing DOM selectors, fabricated review counts, Cloudflare blocking direct fetches, and tools returning partial data without making the failure obvious.

The log/ folder 

Here is where you keep the running journal: meeting summaries (AI transcripts are great here), daily notes, client comments, and small updates that don’t yet deserve to become formal decisions. Most of it won’t be read again. But when something breaks two months later, the answer is often in the log.

One warning: A brain should capture operating knowledge, not raw sensitive data. Don’t turn it into a warehouse for exports, transcripts, credentials, private client documents, or anything the team wouldn’t want surfaced in the wrong context.

Store the lesson, not the raw data.

---

Building the brain step-by-step

Step 1: Pick the right starting client

Don’t start with every client. Pick the account where context loss is already costing you time.

Usually, that means a long-running client with a strong brand voice, a history of rejected ideas, and multiple people touching the work each week.

Step 2: Block 90 minutes and write the soul together

Get the account lead and strategist in the same room or on the same call. Open the five soul files and write in plain sentences. Use real examples. Don’t try to make it perfect.

The goal isn’t to create a brand book. It’s to write down the context your best account person already carries around in their head.

Step 3: Decide where the brain lives

If you’re solo, a local folder may be enough. If you have a team, you need one shared source of truth.

Technical teams can use git: track the Markdown files, not raw client data. Non-technical teams can use Google Drive, Notion, or another shared workspace. The tool matters less than the rule: one client, one brain, one place everyone trusts.

Step 4: Set ownership rules

Soul changes need friction. That’s intentional. If every passing comment gets added to the soul, the brand layer gets polluted. The account lead should own it, review changes, and decide what becomes stable client truth.

Memory should be easier to update. Anyone working on the account should be able to add a sourced entry when a client rejects an angle, a tactic fails, a blocker appears, or the team learns something that shouldn’t be lost.

Step 5: Schedule maintenance

Memory gets messy if nobody owns it. Every couple of weeks, someone should clean the brain: consolidate duplicates, remove stale notes, surface conflicts, and check whether old decisions are still true.

Then schedule a quarterly soul review and ask one question: “Is anything here no longer true?” A stale brain is worse than no brain because the AI will sound confident while working from old context.

How AI agents read the brain

Once a brain exists, the question becomes operational: Which files should the AI agent read whenit starts a brief, audit, competitor analysis, or reporting summary?

This is where the brain proves its day-to-day value. A strategist, content lead, and analyst may all touch the same client in the same week. Without shared context, the brief drifts from the strategy, the content drifts from the brief, and the audit repeats what the team already knows.

The brain keeps that work aligned without turning every task into another meeting, Slack thread, re-explanation, or rewrite. There are three ways to handle this.

Version A: Load everything

The simplest version is to have the AI read every file in the brain folder before it starts: all soul files and the full memory folder.

For a new client, that might only be a few thousand tokens. For a client active for six months, it can become 30K to 50K tokens per session. That’s a real cost, but often still cheaper than the human time lost re-explaining the account every week.

Start here if you’re testing the idea. Run the same task twice: once with the brain loaded, once without it. Use something real, like a content brief, metadata rewrite, technical summary, or internal linking recommendation. If the brain-loaded version is more accurate, more on-brand, or avoids a mistake the team would normally catch manually, you’ve got your signal.

Version B: Route by task type

The next version is selective loading. Instead of asking AI to read everything, you give it a router file that tells it which parts of the brain to load based on the task.

For example:

# claude.md

At the start of every task, ALWAYS read:
- brain/soul/company-profile.md
- brain/soul/never-do.md

IF the task involves writing copy, ALSO read:
- brain/soul/style-guide.md
- brain/soul/audience.md

IF the task involves SEO content briefs, ALSO read:
- brain/soul/keyword-map.md
- brain/memory/decisions/ latest 5 entries
- brain/memory/patterns/content_briefs.md

IF the task involves debugging a tool failure, ALSO read:
- brain/memory/patterns/tool_failures.md

AI reads the instructions, decides which rules apply, and loads only the relevant files. Token cost drops. Context gets cleaner. This is where most agencies should stop for a while.

It’s still just Markdown. No database. No new platform. No complicated setup. The discipline is in writing useful files, keeping them current, and making sure AI reads them before doing the work.

Version C: Vector retrieval

The more advanced version is vector retrieval. If you’re managing 20 or more active clients, each with deep memory, you can tag entries with metadata, embed them into a vector store, and retrieve only the most relevant items at the start of each task.

AI can also write back to memory, but this needs guardrails. Don’t ask it to summarize every session and dump the result into the brain. That creates noise fast. Write to memory only when something specific happens: a task fails, and the team finds a workaround, a client rejects an angle, the account lead corrects the AI on something client-specific, or a decision gets made that should affect future work.

Event-triggered writes are useful. Session-end summaries usually aren’t. And every write needs a source.

Using the brain across Claude Code, Chat, and Cowork

The surface matters less than the pattern. Whether the team is using Claude Code, Claude Chat, Cowork, or another AI workflow, the rule is the same: AI should read the client’s soul before doing anything important.

• In Claude Code, place the brain folder at the root of your project and add a claude.md instruction telling it to read /brain/soul/ at the start of every task. Treat never-do.md as a hard constraint, not a suggestion.
• In Claude Chat, create one project per client and upload the contents of brain/soul/ into Project Knowledge. Don’t share one project across clients. That’s how one client’s tone, rules, or constraints start bleeding into another.
• In Claude Cowork, use a task template that attaches the brain folder at the start. For repeatable tasks like content briefs, SERP reviews, metadata refreshes, or AI visibility audits, build the brain attachment into the workflow.

You’re not just making AI faster. You’re making the starting context consistent.

Where this breaks (and how to fix it)

Once the brain starts shaping real work, a few failure modes show up quickly. Most aren’t technical problems. They’re maintenance problems, which means they’re fixable if someone owns the review process.

• Drift: AI produces work that’s almost right, but slightly off. Usually, the style guide is too abstract. The fix isn’t more adjectives. It’s better examples: pass/fail pairs, before-and-after intros, weak and strong meta descriptions, or a sentence the client rewrote with a note explaining why.
• Stale soul: The client repositions, changes their offer, shifts into a new market, drops a service, or changes how they want to talk about themselves. Nobody updates the soul, so AI keeps producing work from the old reality. The fix is a quarterly soul review. Ask: “Is anything here no longer true?”
• Memory rot: Some memory entries were true when written, but stop being true later. A client rejected comparison content six months ago, then decided to test it. The fix is to date entries clearly, include the reason behind each decision, and remove or update entries when the account changes.
• Fabrication: This is the failure mode to take seriously. AI can write false memory, not maliciously, but because it’s trying to be helpful. When a task fails or a source is incomplete, the model may still produce a clean-looking note that sounds plausible.

We’ve seen AI fabricate ChatGPT search queries, report review counts that weren’t tied to reality, and create explanations for tool failures that sounded reasonable but weren’t supported by the output. Memory compounds. One false entry can influence future briefs, audits, recommendations, and client-facing work.

The fix is provenance. Every factual memory entry needs a source: a meeting note, client quote, tool output, strategist correction, or linked deliverable. No source, no entry.

A brain is only useful if the team trusts it. Trust doesn’t come from the folder structure. It comes from knowing where the knowledge came from.

How to get started this week

You don’t need the full system to start. Start with one client, one 90-minute session, and one before-and-after test.

• Pick one client. Choose the account where re-explaining context costs the most time.
• Block 90 minutes this week. Write the five soul files with the account lead and strategist. Use plain sentences, real examples, and concrete corrections. Don’t let adjectives do all the work.
• Add a router file. Keep it simple at first. At the project root, add one instruction: “At the start of every task, read everything in brain/soul/.”
• Run a real SEO task twice. Use a content brief, keyword cluster, meta description rewrite, SERP analysis, internal linking recommendation, or audit summary. Run it once with the soul loaded and once without it. Compare the outputs honestly.
• Start writing memory from the next session. When AI recommends a ruled-out keyword angle, a client pushes back on tone, or a technical recommendation gets blocked by the CMS, capture the lesson and the reason.

See the complete picture of your search visibility.

Track, optimize, and win in Google and AI search from one platform.

Start Free Trial

Get started with

AI works better when account knowledge survives

Most teams don’t have an AI intelligence problem. They have a context problem. They haven’t written down what their best account people already know, or separated stable client knowledge from working history. That’s what the client brain fixes.

The agencies that get the most from AI won’t just be the ones with better prompts, models, or automations. They’ll be the ones that preserve the context behind the work: the client history, rejected angles, technical constraints, tone corrections, and small decisions that make an account make sense.

Because speed without memory creates more review, more correction, and more “we already talked about this” moments.

The real opportunity isn’t using AI to push more SEO work through the system. It’s using AI to carry forward the context that makes the work better.

Read more at Read More