--- title: "Keep one context file per client so AI drafts know who each client is" description: "AI forgets client names, scope, and preferences between chats. One file per client, in five sections, lets it draft client work without a briefing." canonical: "https://scalewithsearch.com/articles/ai-memory-for-client-management" date: "2026-01-28" modified: "2026-09-25" --- ## Site navigation - [Scale With Search](https://scalewithsearch.com/) - Real estate - Real estate - [Real estate](https://scalewithsearch.com/for/real-estate) - Work - Start here - [Send your brief](https://scalewithsearch.com/work#send-your-brief) - [Prepare your six-question brief](https://scalewithsearch.com/work#prepare-your-six-question-brief) - Build - [Site build, content library with SEO, signal desk](https://scalewithsearch.com/work) - For your business - Trades and home services - [Auto body and collision shops](https://scalewithsearch.com/for/auto-body-and-collision-shops) - [Foundation and home repair contractors](https://scalewithsearch.com/for/foundation-and-home-repair) - [Garage door and fencing contractors](https://scalewithsearch.com/for/garage-door-and-fencing-contractors) - [HVAC contractors](https://scalewithsearch.com/for/hvac-contractors) - [Janitorial and commercial cleaning companies](https://scalewithsearch.com/for/janitorial-and-commercial-cleaning) - [Locksmiths](https://scalewithsearch.com/for/locksmiths) - [Moving companies](https://scalewithsearch.com/for/moving-companies) - [Pest control companies](https://scalewithsearch.com/for/pest-control-companies) - [Plumbing and electrical contractors](https://scalewithsearch.com/for/plumbing-and-electrical-contractors) - [Restoration and water or fire damage companies](https://scalewithsearch.com/for/restoration-and-water-fire-damage) - [Roofing companies](https://scalewithsearch.com/for/roofing-companies) - [Towing companies](https://scalewithsearch.com/for/towing-companies) - [Tree services and landscaping companies](https://scalewithsearch.com/for/tree-services-and-landscaping) - [Solar installers](https://scalewithsearch.com/for/solar-installation) - [General contractors](https://scalewithsearch.com/for/general-contractors-and-construction) - [Paving, concrete, and flooring contractors](https://scalewithsearch.com/for/paving) - Practices and professional services - [Bookkeeping and tax practices](https://scalewithsearch.com/for/bookkeeping-and-tax-practices) - [Dental practices](https://scalewithsearch.com/for/dental-practices) - [Family and criminal defense law firms](https://scalewithsearch.com/for/family-and-criminal-defense-law-firms) - [Med spas and aesthetics practices](https://scalewithsearch.com/for/med-spas-and-aesthetics) - [Personal injury law firms](https://scalewithsearch.com/for/personal-injury-law-firms) - [Veterinary clinics](https://scalewithsearch.com/for/veterinary-clinics) - [Gyms and fitness studios](https://scalewithsearch.com/for/fitness) - [Therapy and outpatient health practices](https://scalewithsearch.com/for/therapy-and-outpatient-health) - [Medical billing companies](https://scalewithsearch.com/for/medical-billing) - [Insurance agencies](https://scalewithsearch.com/for/insurance-agencies) - [Financial advisors](https://scalewithsearch.com/for/financial-advisors) - [Property management companies](https://scalewithsearch.com/for/property-management) - [Recruiting and staffing agencies](https://scalewithsearch.com/for/recruiting-and-staffing) - [Architects and interior designers](https://scalewithsearch.com/for/architects-and-interior-designers) - [Logistics and supply chain companies](https://scalewithsearch.com/for/logistics-and-supply-chain) - Agencies, MSPs, and manufacturing - [IT and managed service providers](https://scalewithsearch.com/for/it-and-managed-service-providers) - [Machine shops and precision manufacturers](https://scalewithsearch.com/for/machine-shops-and-precision-manufacturing) - [Marketing agencies and freelancers](https://scalewithsearch.com/for/marketing-agencies-and-freelancers) - [SEO agencies and consultants](https://scalewithsearch.com/for/seo-agencies-and-consultants) - [Small manufacturers and fabricators](https://scalewithsearch.com/for/small-manufacturers-and-fabricators) - Restaurants, shops, studios, and nonprofits - [Restaurants and hospitality businesses](https://scalewithsearch.com/for/restaurants-and-hospitality) - [Retail stores and ecommerce sellers](https://scalewithsearch.com/for/retail-and-ecommerce) - [Photographers, event planners, and travel agents](https://scalewithsearch.com/for/photographers) - [Churches and nonprofits](https://scalewithsearch.com/for/churches-and-nonprofits) - [All industries](https://scalewithsearch.com/for/) - Learn - For your office - [Office job guides](https://scalewithsearch.com/guides/) - [Browser calculators](https://scalewithsearch.com/tools/) - Start here - [How it works](https://scalewithsearch.com/how-it-works) - [Free Starter Kit](https://scalewithsearch.com/kit/business-memory-starter-kit.zip) - [Synthetic specimen](https://scalewithsearch.com/specimen/working-session-specimen.zip) - Guides - [The Complete Guide to Business Memory for AI Agents](https://scalewithsearch.com/articles/business-memory-for-ai-agents-guide) - [The Complete Small-Business Guide to AI Agent Governance](https://scalewithsearch.com/articles/ai-agent-governance-guide-small-business) - [The Complete Guide to Leaving Vendor AI Memory](https://scalewithsearch.com/articles/leaving-vendor-ai-memory-guide) - Articles by cluster - [Business memory](https://scalewithsearch.com/articles/business-memory-for-ai-agents-guide) - [Agent governance](https://scalewithsearch.com/articles/ai-agent-governance-guide-small-business) - [Migration and ownership](https://scalewithsearch.com/articles/leaving-vendor-ai-memory-guide) - For machines - [llms.txt](https://scalewithsearch.com/llms.txt) - [llms-full.txt](https://scalewithsearch.com/llms-full.txt) - [Machine view](https://scalewithsearch.com/?view=machine) - Company - Evidence - [Proof](https://scalewithsearch.com/proof) - Company - [About](https://scalewithsearch.com/about) # Keep one context file per client so AI drafts know who each client is. "Draft a follow-up to John about Q2." The AI replies: "Who is John? What is Q2 about?" You have described John three times this month. The AI has no record of it. Every chat starts from zero, so you explain the client, the project, and the history again. The assistant that should save time costs time. A chat tool does not reliably keep client details between sessions. It does not know that John owns a three-location veterinary clinic, prefers morning calls, and needs content for each location. A client context file fixes this. One file per client holds the name, company, scope, preferences, and history. The AI reads it before any task for that client. Then "follow-up to John about Q2" is enough. ## What client management looks like with context Give the AI one Markdown file per client relationship, and it becomes client-aware. Each file stores five things: - basic information: name, company, role, and contact channel; - project scope: current work, timeline, and deliverables; - communication preferences: email or calls, response time, meeting times; - history: past projects, decisions, and what worked; - notes: goals, pain points, and details worth keeping. When you ask the AI to draft an email, plan a call, or summarize project status, it has the client's context. No "who is this?" and no briefing. ## Write the five sections The example below is fictional. Replace every value with your own client's facts. Start with the basics: who the client is and what you do for them. ```markdown ## Client: John Martinez company:: Northgate Veterinary Clinic (Columbus, OH) role:: owner and lead veterinarian contact:: john@example.com locations:: 3 clinics (North, South, Westside) project:: SEO and content marketing start_date:: 2025-10 contract:: month-to-month, 30-day notice fees_and_terms:: see contracts/northgate.md ``` Add the communication preferences: how the client likes to work with you. ```markdown ## Communication preferences - Email: short updates with bullet points - Calls: mornings only, 8 to 10 a.m. Eastern - Meetings: check-ins on the 2nd and 4th Tuesday - Response time: 24 to 48 hours is fine - Style: direct, no corporate language - Dislikes: long emails with buried questions ``` Document the scope: what you deliver and when. ```markdown ## Scope Deliverables: - 4 blog posts a month, 1,200 to 1,500 words each - Google Business Profile upkeep for all 3 locations - Monthly SEO report - Quarterly keyword refresh Topics: - Preventive care - Senior pet care - Dental health for pets Avoid: - Diagnosis content - Medication or dosing advice - Generic "pet care 101" filler ``` Track the history: past results, past mistakes, and the reasons for decisions. ```markdown ## History 2025-10: onboarded. Audit showed weak local rankings and thin content. 2025-11: published 4 posts, set up the business profiles. Traffic change: see the November report. 2025-12: slow holiday month. John paused new content. 2026-01: resumed. New focus: senior pet care, John's specialty. What works: - Case-style posts about real treatment journeys (with owner consent) - Short video clips that John records - Local keywords for each location What does not work: - Generic introductory posts - Posts over 2,000 words; John's readers want quick answers ``` Add notes: facts that do not fit elsewhere but shape the work. ```markdown ## Notes - John wants the clinic known for senior pet care. - The North location brings the most revenue. - A 4th location is under consideration for 2026. - The practice manager handles scheduling; do not copy her on content email. ``` ## Set it up Create one file per client, such as `client-john-martinez.md`, with the five sections: 1. Client information: name, company, contact channel, project basics. 2. Communication preferences: how they work and what they expect. 3. Project scope: deliverables, topics, and exclusions. 4. History: a dated timeline of work, with what worked and what did not. 5. Notes: anything else that shapes the work. Save the files in an Obsidian vault or any folder. In Claude Code, add a line to the root `CLAUDE.md` that tells it to read the matching client file when a task names a client. Keep each client in its own file, and load only the client the task names. The guide to [separating client context before an agent touches the work](/articles/separate-client-context-before-agent-work) explains why a shared file can leak one client's facts into another's work. ## Before and after Before, without a client file: > **You:** "Draft a follow-up to John about Q2 deliverables." > > **AI:** "Who is John? Which deliverables do you mean?" > > **You:** "John Martinez, the vet clinic client. We do SEO for him." > > **AI:** "Got it. What is the scope of the SEO work?" > > **You:** "Four blog posts a month, business profile upkeep, reports." > > **AI:** [a generic corporate email] > > **You:** [ten minutes of rewrites] After, with the file loaded: > **You:** "Draft a follow-up to John about Q2 deliverables." > > **AI:** [reads client-john-martinez.md] > > Subject: Q2 plan: senior pet care focus > > John, > > Here's the Q2 lineup: > > Content > - 12 posts, April to June, with a senior pet care focus > - 4 video clips (can you record short ones?) > - North location profile update with new service pages > > SEO > - Keyword refresh for "senior pet vet Columbus" > - Monthly reports in the Q1 format > > Can we meet on the 2nd Tuesday in April to review? > > [Your name] No back-and-forth. The AI knew the client, the scope, and the style. You still read the draft before it goes out. ## What the file fixes and what it does not The file stops four repeats. You no longer explain the client in each chat. You no longer forget preferences, because the communication rules are written down. Client email stops sounding generic, because the AI knows the relationship and its history. You no longer ask yourself what was decided last month, because the history section records it. The file has limits. It does not track deadlines; you still need a project management tool. It does not update itself; when the scope changes, you edit the file. It does not replace meeting notes; it holds the reference facts, not the transcript. For decisions from meetings, the guide to [AI memory for meeting notes](/articles/ai-memory-meeting-notes-decisions) shows how to keep them separate from the raw record. ## Onboard a new client in fifteen minutes A new client file does not need a full history on day one. Build it from the documents you already have. 1. Copy the five-section template into a new file named after the client. 2. Fill the client information from the signed agreement: company, contact, start date, and a pointer to the contract file. 3. Fill the scope from the statement of work. Copy the deliverables list word for word, so the assistant never invents a deliverable. 4. Fill the communication preferences from the kickoff call. If you did not ask, ask in the first email: preferred channel, best time for calls, and how much detail they want. 5. Leave the history section with one dated line: "Onboarded; kickoff call on [date]." The notes section stays empty until something worth noting happens. A file that starts small and grows is easier to trust than a file that starts full of guesses. ## Test the file with three questions Run this check in a fresh session before you draft anything the client will see. 1. Ask "What do we deliver for John each month?" Pass: the answer matches the scope section line by line. Fail: it adds a deliverable, drops one, or gives a generic list. 2. Ask "When can I call John?" Pass: mornings, 8 to 10 a.m. Eastern. Fail: a generic suggestion. 3. Ask "What did we decide in January?" Pass: the answer cites the January history entry. Fail: it paraphrases or invents. A fail on the first question is the one to fix first, because a wrong deliverable in a client email costs trust. Copy the scope wording again, and run the question again. ## Keep personal details minimal A client file holds facts about real people. Store what the work needs and nothing more. Business contact channels belong in the file. Home addresses, health details, and private remarks about family members do not. The article on [what client data belongs in AI agent memory](/articles/client-data-in-ai-agent-memory) sets the limits. It also covers what the AI provider receives when a tool reads the file. ## Keep the file accurate A stale client file is worse than none, because the AI states old facts with confidence. Update the file after any meeting that changes scope, dates, or preferences. Add a `last_verified` date at the top, and check it before a task that goes to the client. Most people cannot hold ten or more client relationships in full detail. Names blur, preferences slip, and last month's decision fades. The client file carries that load for you and for the AI. For an agency with many accounts, the guide to [building an agency brain that retains client context](/articles/agency-brain-retains-client-context) scales the same pattern to a team. ## Related: AI memory - [How to Build an Agency Brain That Retains Client Context Without Mixing Accounts](/articles/agency-brain-retains-client-context) - [AI Memory for Freelancers: Keep Client Context Separate Without Re-Explaining Every Brief](/articles/ai-memory-for-freelancers) - [Best Platform for Company Context Across AI Tools: What Must Follow the Job?](/articles/best-platform-company-context-across-ai-tools) ---- ```text .|########||. .|########||. .|########||. |##||. .||##|. |##||. .||##|. |##||. .||##|. |#|. .|#|. |#|. .|#|. |#|. .|#|. |#| |#| |#| |#| |#| |#| .#| |#. .#| |#. .#| |#. .#. .#| .#. .#| .#. .#| |#. .#| |#. .#| |#. .#| |# ...... #| |# ...... #| |# ...... #| .# ||#########| #| .# ||#########| #| .# ||#########| #| .#. |######||######|. .#. .#. |######||######|. .#. .#. |######||######|. .#. #. .##|###|##|#|######| .# #. .##|###|##|#|######| .# #. .##|###|##|#|######| .# || |##|#||||||||||||#||#| || || |##|#||||||||||||#||#| || || |##|#||||||||||||#||#| || # |#||||||||||||||||||||#| #. # |#||||||||||||||||||||#| #. # |#||||||||||||||||||||#| #. || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || # .#||||||||||||||||||||||||#| # # .#||||||||||||||||||||||||#| # # .#||||||||||||||||||||||||#| # || ....|||#||||||##|#|||#|#||##||||....|. || || ....|||#||||||##|#|||#|#||##||||....|. || || ....|||#||||||##|#|||#|#||##||||....|. || #. . ....|# ....#||| ||| .#||| ....#. .# #. . ....|# ....#||| ||| .#||| ....#. .# #. . ....|# ....#||| ||| .#||| ....#. .# # . ||||#| .#####|| . .#| .#||| ||||# #. # . ||||#| .#####|| . .#| .#||| ||||# #. # . ||||#| .#####|| . .#| .#||| ||||# #. .| ||||| #. |#|||||. || #. |#||. .||||| || .| ||||| #. |#|||||. || #. |#||. .||||| || .| ||||| #. |#|||||. || #. |#||. .||||| || || |.... #. ....|#. |. ...|. ....|| || || |.... #. ....|#. |. ...|. ....|| || || |.... #. ....|#. |. ...|. ....|| || #. .||||||##||||||##||####|||||||#||||||#| .# #. .||||||##||||||##||####|||||||#||||||#| .# #. .||||||##||||||##||####|||||||#||||||#| .# # .||####|###########################|. # # .||####|###########################|. # # .||####|###########################|. # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#||||||.#.|| # |. ..# #| #|||||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||||| .. |# ## |#| ...#|#|||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#|||#|# .# .#| #| ##|.#..#|||||#| # # .#||||||############|######|||||#| # # .#||||||############|######|||||#| # # .#||||||############|######|||||#| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # # |...||#||||||#||||#|#||||||#|||||#||| |.| # #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# #. .. ||||# .|||##|. |#| .|| || .|||#. #| # .# || | ...|| ...##| | #| .|. |. ##### .. .| || || | ...|| ...##| | #| .|. |. ##### .. .| || || | ...|| ...##| | #| .|. |. ##### .. .| || || ||||| || ||||#| . |. |. |#. ||||| |#| || || || ||||| || ||||#| . |. |. |#. ||||| |#| || || || ||||| || ||||#| . |. |. |#. ||||| |#| || || .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. .# |.....#|....|#.||||.|||##.|#|....||.#||.#. #. #.|||||||#############################| ||| .# #.|||||||#############################| ||| .# #.|||||||#############################| ||| .# || ##||#||#||||||#||#||#||#||##. || || ##||#||#||||||#||#||#||#||##. || || ##||#||#||||||#||#||#||#||##. || # .#|||||||||#||#|||||||||||#| # # .#|||||||||#||#|||||||||||#| # # .#|||||||||#||#|||||||||||#| # || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || || |#||||||||||||||||||||||#| || .# |#||||||||||||||||||||#| #. .# |#||||||||||||||||||||#| #. .# |#||||||||||||||||||||#| #. || |#||||||||||||||||||#| || || |#||||||||||||||||||#| || || |#||||||||||||||||||#| || #. .######|#|#########| .# #. .######|#|#########| .# #. .######|#|#########| .# .#. |#####||||#####| .#. .#. |#####||||#####| .#. .#. |#####||||#####| .#. |# ||########|| #. |# ||########|| #. |# ||########|| #. |# ...... #| |# ...... #| |# ...... #| |#. .#| |#. .#| |#. .#| |#. .#. |#. .#. |#. .#. .#| |#. .#| |#. .#| |#. |#| |#| |#| |#| |#| |#| .|#|. .|#|. .|#|. .|#|. .|#|. .|#|. |##||. .||##| |##||. .||##| |##||. .||##| .||########||. .||########||. .||########||. Scale With Search 2026 [scalewithsearch.com](https://scalewithsearch.com) ```