All guides

Start here · Lesson 1.1

Give AI a Memory: Stop Re Explaining Your Business

Rafay Korai · 6 min read · 2026-11-04

You open a new chat and spend the first ten minutes explaining your business again. What you sell, who buys it, how you sound, what you decided last week. Then the session ends and it all disappears.

The fix is a memory: a small file the AI reads at the start of every session. This guide shows what goes in it, how to write it, and how to keep it useful.

A memory file is a short, plain document in your project folder. Claude Code loads it at the start of every session, so you brief it once instead of every time. It is treated as context, not a hard lock, so the clearer and shorter it is, the better it is followed.

Why AI forgets

An AI model does not keep your last conversation by default. Anthropic's docs say each Claude Code session begins with a fresh context window, and that two things carry knowledge across sessions: CLAUDE.md files you write, and auto memory, which are notes Claude writes itself from your corrections and preferences.

The file is named CLAUDE.md and can live at ./CLAUDE.md or ./.claude/CLAUDE.md in your project, or at ~/.claude/CLAUDE.md for personal preferences across all projects. It is loaded at the start of every session and treated as context, not enforced configuration.

What belongs in the file

Keep it to things that stay true for weeks. Five sections cover most people.

  1. The businessWhat you sell, to whom, and your goal right now. Two or three sentences.
  2. The voiceHow you write. Plain words or formal, short sentences or long, words you never use.
  3. The factsReal numbers, product names and links the AI should never guess. Put your own prices here.
  4. The decisionsChoices already made, so it does not reopen them. "We use one blue. We post three times a week."
  5. The rulesThings it must always or never do. "Never send an email without showing me first."

A short example

Illustrative example only. This is a small bakery in Leeds that sells sourdough by subscription. The reader is a busy parent. Goal this quarter: more subscribers, not more followers. Voice: warm, plain, no exclamation marks. Prices: [your loaf price], [your weekly box price]. Decision: we do not discount. Rule: draft first, never publish.

That is about sixty words and it removes most of the repeated explaining.

How to build it without writing it by hand

You do not have to type this from a blank screen. Ask Claude Code to look through the folder and draft it for you: "Read what is in this folder, then write a CLAUDE.md with the business, the voice, the facts, the decisions and the rules. Tell me what you could not find." Then correct it.

You can also run the /init command, which the docs describe as generating a starting CLAUDE.md by analysing the project. It is aimed at code projects, so for a business folder the plain request above may suit better. Either way, read the result and correct it.

Keep it short

A long memory file is a weak one. The docs suggest targeting under 200 lines per CLAUDE.md file, because longer files use more context and reduce how well they are followed. If it is pages long, important rules get buried. Move bulky material, such as a full price list, into its own file and point to it: "Prices are in prices.md."

Review it monthly. Delete anything that is no longer true. A stale memory is worse than none, because the AI will follow it confidently.

Teach it as you go

The best habit is to end a session with one line: "Add anything we decided today to the memory file." Over time the file becomes a record of how your business works. It pairs well with the idea in the brief once method, where every correction becomes a rule that sticks.

What not to put in it

  • Passwords, API keys or bank details.
  • Private information about other people.
  • Things that change daily, like today's to do list.
  • Long documents. Link to them instead.

Check that it works

Start a fresh session and ask: "What do you know about my business?" If the answer matches your file, it is loaded. You can also run /context and look under Memory files, as the docs suggest. If it is missing, check that you opened Claude Code in the right folder.

Why this matters

Without memory, every session pays a setup tax. With it, the AI starts each job already knowing the basics, and your brief only needs to cover what is new. If you use the five part brief, memory holds the parts that never change.

A worked example of a first memory file

Say you run a freelance photography business. Your first draft of the memory file could say who you shoot for, such as small restaurants and cafes. It could state your style in plain terms: bright, natural light, no heavy filters. It could list facts the AI should not invent, such as your package names and the way you quote. It could record one decision, such as always asking for a shot list before a booking. And it could carry two rules: draft client emails for approval, and never promise a delivery date.

None of that is long, yet it changes every later session. When you ask for a quote email, it already knows your packages and your tone. When you ask for a caption, it knows the style.

How often to update it

Update it when something changes, not on a timer alone. A new product, a changed price, a new rule you have taught: add it the same day. Once a month, read the whole file and delete what is stale. If you have more than one business or client, give each its own folder and its own file, so the context never leaks from one to another.

Common problems

The AI ignores part of it. The file is probably too long. Cut it and move detail into linked files.

It contradicts itself. Two lines disagree. Find them and keep one.

It sounds too stiff. Your voice section is too rigid. Add an example paragraph you like and say "sound like this".

Questions people ask

What is CLAUDE.md?

It is a markdown file, which is plain text, that Claude Code reads at the start of each session. It holds standing instructions and facts about your work.

Does the AI remember everything from past chats?

Not by default. Each session starts fresh, apart from CLAUDE.md files and auto memory notes, so write down what you want kept.

How long should the file be?

Short. The docs suggest under 200 lines. Link to longer documents instead of pasting them in.

Can I edit it myself?

Yes. It is just a text file. You can edit it any time, or ask Claude Code to update it.

Next step

Lesson 1.1 shows how to give Claude Code a memory on screen. The next lesson, Build your brand's brain, takes the idea to a whole business.

Go deeper with the lesson

This guide gives you the idea. Lesson 1.1, Set up AI to do real work for you takes you through it step by step, in plain words, so you can do it for your own business.