{"id":17245,"date":"2026-11-05T09:00:00","date_gmt":"2026-11-05T15:00:00","guid":{"rendered":"https:\/\/mindbacklog.com\/blog\/?p=17245"},"modified":"2026-11-05T09:00:00","modified_gmt":"2026-11-05T15:00:00","slug":"claude-md-best-practices","status":"publish","type":"post","link":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/","title":{"rendered":"CLAUDE.md best practices: tell the agent who your users are"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The CLAUDE.md best practice most founders miss is product context: who your users are, what the product won&#8217;t do, and the rules you agreed with them. Claude Code reads your code style and folder layout from the repo, so those lines add little. Keep the file to what&#8217;s true on every task, and give each feature&#8217;s why, metric and must-haves their own brief.<\/p>\n\n\n\n<div class=\"mbb-summary\"><span class=\"mbb-summary-label\">In short<\/span><ul>\n<li>Write down only what Claude can&#8217;t learn from the code. Your users top that list.<\/li>\n<li>Add who the users are, what&#8217;s out of scope, product rules and the words users use.<\/li>\n<li>Leave out folder layout, linter rules and anything true for only one feature.<\/li>\n<li>Keep each feature&#8217;s why, metric and must-haves in a per-feature brief.<\/li>\n<\/ul><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Start from what the repo can&#8217;t tell Claude<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Claude Code loads CLAUDE.md at the start of every session, and Anthropic&#8217;s <a href=\"https:\/\/code.claude.com\/docs\/en\/memory\">memory docs<\/a> suggest keeping each file under 200 lines. Every line competes for attention on every task. So start with a filter before you reach for a template.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Anthropic&#8217;s best practices give that filter as two questions: &#8220;Could it find this by reading the code?&#8221; and &#8220;Would it actually go and look?&#8221; If both answers are yes, the line goes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Run that filter on a typical file and most of it disappears: the framework, the folder tree, the naming style. What survives is knowledge that never made it into the repo. For a founder, the biggest piece of that is the person the product is for.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Name your users in two or three lines<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Without a user, Claude designs for a default one. The default user wants settings, options and an admin screen for everything. Your real users usually want one job done with less effort, on a device you know, in a situation you&#8217;ve watched.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, a founder building a booking tool for solo physiotherapists might rewrite the top of the file like this.<\/p>\n\n\n\n<div class=\"mbb-pair\">\n<div class=\"mbb-no\"><span class=\"mbb-label\">Instead of<\/span><p>This is a Next.js app for booking appointments, using Postgres and Tailwind.<\/p><\/div>\n<div class=\"mbb-yes\"><span class=\"mbb-label\">Try<\/span><p>Users are physiotherapists who run a clinic alone. They book and move sessions on a phone between patients. Their patients are mostly over 50 and get reminders by text.<\/p><\/div>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Those three lines change small decisions all over the codebase. Claude sizes tap targets for a phone, keeps forms short, and writes reminder copy an older patient can follow. You never had to ask for any of it.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Say what the product won&#8217;t do<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Coding agents say yes to plausible scope. Ask for a booking change and you may get a waitlist, a group class option and a calendar sync nobody requested. An out-of-scope list gives Claude a reason to stop.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Keep the list to things Claude might reasonably build. &#8220;No blockchain&#8221; wastes a line. &#8220;No group classes, every booking is one patient and one clinician&#8221; prevents real work you&#8217;d later delete.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Write down product rules and your users&#8217; words<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Some decisions live in support threads and calls, not in code. Others are in the code but easy to break. Both belong in the file, phrased so Claude can act on them.<\/p>\n\n\n\n<figure class=\"mbb-table\"><table><thead><tr><th>Kind of line<\/th><th>Example<\/th><th>Why Claude can&#8217;t infer it<\/th><\/tr><\/thead><tbody>\n<tr><td>Product rule<\/td><td>Never cancel a session automatically. The clinician confirms every cancellation.<\/td><td>Users asked for it on calls, and the code allows both<\/td><\/tr>\n<tr><td>Privacy rule<\/td><td>Patients never see another patient&#8217;s name, even on a waitlist.<\/td><td>Nothing in the schema says so<\/td><\/tr>\n<tr><td>Users&#8217; words<\/td><td>Users say &#8220;session&#8221;, never &#8220;appointment&#8221;. Copy follows them.<\/td><td>The database table is called appointments<\/td><\/tr>\n<tr><td>Done means<\/td><td>Run pnpm test and pnpm lint, then show the output.<\/td><td>The repo has three test scripts and one is stale<\/td><\/tr>\n<\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The vocabulary line matters more than it looks. Agents copy names from the code into the interface, so without it your users start seeing &#8220;appointment&#8221; on buttons and in emails.<\/p>\n\n\n\n<div class=\"mbb-callout\"><p><strong>Note.<\/strong> Claude treats CLAUDE.md as context rather than enforced configuration, so it follows the file nearly every time. For a rule that can have no exceptions, such as never reading the production env file, Anthropic recommends a hook or a permission deny rule instead.<\/p><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Put the product block at the top<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Here is the whole product section for the physiotherapy example. It&#8217;s short on purpose. Commands and gotchas can follow it, and the file still fits on one screen.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code># Users\nPhysiotherapists who run a clinic alone.\nThey manage bookings on a phone between patients.\nPatients are mostly over 50. Reminders go by text.\n\n# Out of scope\n- Group classes. One patient, one clinician.\n- Insurance billing and claims.\n\n# Product rules\n- Never cancel a session automatically.\n- Patients never see another patient's name.\n- Users say \"session\", not \"appointment\".\n\n# Done means\npnpm test and pnpm lint pass. Show the output.<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Keep each feature&#8217;s context out of the file<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The tempting next step is to paste your current feature into CLAUDE.md. That text then rides along on every unrelated bug fix, and it goes stale the day the feature ships.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A feature needs its own brief: why it matters, who it&#8217;s for, the metric that should move, and the must-haves with acceptance criteria. MindBacklog calls this a Build Pack, and you can also write one by hand as a spec file. The <a href=\"https:\/\/mindbacklog.com\/guides\/build-pack-format\">Build Pack format guide<\/a> lists each section. Point the session at the brief when you start the feature.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Don&#8217;t pull the brief in with an @ import. The docs note that imported files load in full alongside the CLAUDE.md that imports them, so an import saves no context. Name the file in your prompt instead.<\/p>\n\n\n\n<figure class=\"mbb-diagram\"><span class=\"mbb-diagram-title\">WHAT GOES IN CLAUDE.MD<\/span><div class=\"mbb-cols\"><div class=\"mbb-col\"><span class=\"mbb-label\">What most files hold<\/span><ul><li>Folder layout Claude can read<\/li><li>Style rules a linter enforces<\/li><li>The framework and its version<\/li><li>One feature&#x27;s full spec<\/li><\/ul><\/div><div class=\"mbb-col is-good\"><span class=\"mbb-label\">What Claude can&#x27;t see<\/span><ul><li>Who your users are<\/li><li>What the product won&#x27;t do<\/li><li>Rules agreed with users<\/li><li>The words your users use<\/li><li>How to prove work is done<\/li><\/ul><\/div><\/div><figcaption>Most CLAUDE.md files describe the code. The useful lines describe what the code can&#x27;t show.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Test every line before it stays<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Run each line through this list when you write the file, and again whenever you touch it.<\/p>\n\n\n\n<ul class=\"mbb-checklist\">\n<li>Claude couldn&#8217;t learn it by reading the code<\/li>\n<li>It&#8217;s true on every task, not only the current feature<\/li>\n<li>It names something specific: a user, a command, a word, a folder<\/li>\n<li>It doesn&#8217;t contradict another line or a nested CLAUDE.md<\/li>\n<li>If it must never be broken, it&#8217;s a hook or deny rule instead<\/li>\n<li>A new teammate would need it too<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Update it when Claude repeats a mistake<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The docs suggest adding to CLAUDE.md when Claude makes the same mistake a second time, or when you type a correction you already typed last session. That keeps the file grounded in real misses rather than guesses.<\/p>\n\n\n\n<ol class=\"mbb-steps\">\n<li><strong>Start from \/init.<\/strong> It drafts a file from your codebase. Most of the work after that is deleting lines.<\/li>\n<li><strong>Add the product block.<\/strong> Users, out of scope, product rules, words, and how to prove work is done.<\/li>\n<li><strong>Move narrow rules out.<\/strong> A rule for one folder goes in .claude\/rules\/ with a paths filter, so it loads only there.<\/li>\n<li><strong>Move personal habits out.<\/strong> Your own preferences go in CLAUDE.local.md, which you add to .gitignore.<\/li>\n<li><strong>Check what loaded.<\/strong> Run \/context in a session and look for the file under Memory files.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">If you build with Claude Code or Cursor most days, see <a href=\"https:\/\/mindbacklog.com\/for\/builder-founders\">how MindBacklog works for builder founders<\/a>.<\/p>\n\n\n\n<div class=\"mbb-inline-cta\"><p><strong>See what goes in the per-feature brief.<\/strong> A sample Build Pack for a made-up product, with every section&#8217;s source.<\/p><a href=\"https:\/\/mindbacklog.com\/sample-build-pack\">See a sample Build Pack<\/a><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Doing this in MindBacklog<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">MindBacklog keeps what your users said, ranks the problems they have, and hands your coding agent the why. For each feature, the Build Pack carries why it matters, who it&#8217;s for, the metric, and the must-haves with acceptance criteria, so CLAUDE.md can stay short. A Build Pack never carries a customer&#8217;s name, email, company, plan or revenue. <a href=\"https:\/\/mindbacklog.com\/features\/build-pack\">How the Build Pack works<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Questions<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">What should a CLAUDE.md file include?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Include what Claude can&#8217;t learn from the code: who your users are, what&#8217;s out of scope, product rules, the words users use, and the commands that prove work is done. Gotchas belong too, such as a legacy folder new code shouldn&#8217;t copy. Leave out what the repo already shows.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How long should a CLAUDE.md file be?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Anthropic&#8217;s docs suggest keeping each CLAUDE.md file under 200 lines, because longer files use more context and Claude follows them less reliably. Most founders&#8217; files can be far shorter. If yours keeps growing, move folder-specific rules into .claude\/rules\/ and feature detail into per-feature briefs.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Does Claude always follow CLAUDE.md?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">No. Claude Code treats CLAUDE.md as context rather than enforced configuration, so it follows the file nearly every time. Short, specific lines get followed most reliably. For a rule with no exceptions, use a hook or a permission deny rule.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Claude reads your code. It can&#8217;t read your users. What belongs in CLAUDE.md beyond code style, and what belongs in a per-feature brief instead.<\/p>\n","protected":false},"author":1,"featured_media":17214,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[60],"tags":[63,65,64,66],"class_list":["post-17245","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-technical-founders","tag-build-pack","tag-claude-code","tag-coding-agents","tag-specs"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.8 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>CLAUDE.md best practices: tell the agent who your users are - MindBacklog<\/title>\n<meta name=\"description\" content=\"CLAUDE.md best practices for founders: name your users, say what&#039;s out of scope, write down product rules, and keep each feature&#039;s context out of the file.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"CLAUDE.md best practices: tell the agent who your users are - MindBacklog\" \/>\n<meta property=\"og:description\" content=\"CLAUDE.md best practices for founders: name your users, say what&#039;s out of scope, write down product rules, and keep each feature&#039;s context out of the file.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/\" \/>\n<meta property=\"og:site_name\" content=\"MindBacklog\" \/>\n<meta property=\"article:author\" content=\"https:\/\/facebook.com\" \/>\n<meta property=\"article:published_time\" content=\"2026-11-05T15:00:00+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/11\/claude-md-best-practices-cover.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1600\" \/>\n\t<meta property=\"og:image:height\" content=\"900\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Aadarsh Bohara\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Aadarsh Bohara\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/\"},\"author\":{\"name\":\"Aadarsh Bohara\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#\\\/schema\\\/person\\\/2610248f03a31c2b44426748a9585601\"},\"headline\":\"CLAUDE.md best practices: tell the agent who your users are\",\"datePublished\":\"2026-11-05T15:00:00+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/\"},\"wordCount\":1453,\"publisher\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/claude-md-best-practices-cover.jpg\",\"keywords\":[\"Build Pack\",\"Claude Code\",\"Coding agents\",\"Specs\"],\"articleSection\":[\"Technical Founders\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/\",\"url\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/\",\"name\":\"CLAUDE.md best practices: tell the agent who your users are - MindBacklog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/claude-md-best-practices-cover.jpg\",\"datePublished\":\"2026-11-05T15:00:00+00:00\",\"description\":\"CLAUDE.md best practices for founders: name your users, say what's out of scope, write down product rules, and keep each feature's context out of the file.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#primaryimage\",\"url\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/claude-md-best-practices-cover.jpg\",\"contentUrl\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/11\\\/claude-md-best-practices-cover.jpg\",\"width\":1600,\"height\":900,\"caption\":\"CLAUDE.md best practices: tell the agent who your users are\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/claude-md-best-practices\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CLAUDE.md best practices: tell the agent who your users are\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/\",\"name\":\"MindBacklog\",\"description\":\"Silence the Noise. Build with Clarity.\",\"publisher\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#organization\",\"name\":\"MindBacklog\",\"url\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/03\\\/v205imk2q4mmlbxt96.svg\",\"contentUrl\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/wp-content\\\/uploads\\\/2026\\\/03\\\/v205imk2q4mmlbxt96.svg\",\"width\":275,\"height\":40,\"caption\":\"MindBacklog\"},\"image\":{\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/mindbacklog.com\\\/blog\\\/#\\\/schema\\\/person\\\/2610248f03a31c2b44426748a9585601\",\"name\":\"Aadarsh Bohara\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/564b8eec18621821954ee9695a267912229d6f992be8e59ab192d05938085cc5?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/564b8eec18621821954ee9695a267912229d6f992be8e59ab192d05938085cc5?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/564b8eec18621821954ee9695a267912229d6f992be8e59ab192d05938085cc5?s=96&d=mm&r=g\",\"caption\":\"Aadarsh Bohara\"},\"description\":\"Building the product management tool I wish I had. Multiple startup exits. Writing about AI, product strategy, and what it takes to build things people want.\",\"sameAs\":[\"https:\\\/\\\/mindbacklog.com\\\/blog\",\"https:\\\/\\\/facebook.com\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"CLAUDE.md best practices: tell the agent who your users are - MindBacklog","description":"CLAUDE.md best practices for founders: name your users, say what's out of scope, write down product rules, and keep each feature's context out of the file.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/","og_locale":"en_US","og_type":"article","og_title":"CLAUDE.md best practices: tell the agent who your users are - MindBacklog","og_description":"CLAUDE.md best practices for founders: name your users, say what's out of scope, write down product rules, and keep each feature's context out of the file.","og_url":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/","og_site_name":"MindBacklog","article_author":"https:\/\/facebook.com","article_published_time":"2026-11-05T15:00:00+00:00","og_image":[{"width":1600,"height":900,"url":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/11\/claude-md-best-practices-cover.jpg","type":"image\/jpeg"}],"author":"Aadarsh Bohara","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Aadarsh Bohara","Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#article","isPartOf":{"@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/"},"author":{"name":"Aadarsh Bohara","@id":"https:\/\/mindbacklog.com\/blog\/#\/schema\/person\/2610248f03a31c2b44426748a9585601"},"headline":"CLAUDE.md best practices: tell the agent who your users are","datePublished":"2026-11-05T15:00:00+00:00","mainEntityOfPage":{"@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/"},"wordCount":1453,"publisher":{"@id":"https:\/\/mindbacklog.com\/blog\/#organization"},"image":{"@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#primaryimage"},"thumbnailUrl":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/11\/claude-md-best-practices-cover.jpg","keywords":["Build Pack","Claude Code","Coding agents","Specs"],"articleSection":["Technical Founders"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/","url":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/","name":"CLAUDE.md best practices: tell the agent who your users are - MindBacklog","isPartOf":{"@id":"https:\/\/mindbacklog.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#primaryimage"},"image":{"@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#primaryimage"},"thumbnailUrl":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/11\/claude-md-best-practices-cover.jpg","datePublished":"2026-11-05T15:00:00+00:00","description":"CLAUDE.md best practices for founders: name your users, say what's out of scope, write down product rules, and keep each feature's context out of the file.","breadcrumb":{"@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#primaryimage","url":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/11\/claude-md-best-practices-cover.jpg","contentUrl":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/11\/claude-md-best-practices-cover.jpg","width":1600,"height":900,"caption":"CLAUDE.md best practices: tell the agent who your users are"},{"@type":"BreadcrumbList","@id":"https:\/\/mindbacklog.com\/blog\/claude-md-best-practices\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/mindbacklog.com\/blog\/"},{"@type":"ListItem","position":2,"name":"CLAUDE.md best practices: tell the agent who your users are"}]},{"@type":"WebSite","@id":"https:\/\/mindbacklog.com\/blog\/#website","url":"https:\/\/mindbacklog.com\/blog\/","name":"MindBacklog","description":"Silence the Noise. Build with Clarity.","publisher":{"@id":"https:\/\/mindbacklog.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/mindbacklog.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/mindbacklog.com\/blog\/#organization","name":"MindBacklog","url":"https:\/\/mindbacklog.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/mindbacklog.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/03\/v205imk2q4mmlbxt96.svg","contentUrl":"https:\/\/mindbacklog.com\/blog\/wp-content\/uploads\/2026\/03\/v205imk2q4mmlbxt96.svg","width":275,"height":40,"caption":"MindBacklog"},"image":{"@id":"https:\/\/mindbacklog.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/mindbacklog.com\/blog\/#\/schema\/person\/2610248f03a31c2b44426748a9585601","name":"Aadarsh Bohara","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/564b8eec18621821954ee9695a267912229d6f992be8e59ab192d05938085cc5?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/564b8eec18621821954ee9695a267912229d6f992be8e59ab192d05938085cc5?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/564b8eec18621821954ee9695a267912229d6f992be8e59ab192d05938085cc5?s=96&d=mm&r=g","caption":"Aadarsh Bohara"},"description":"Building the product management tool I wish I had. Multiple startup exits. Writing about AI, product strategy, and what it takes to build things people want.","sameAs":["https:\/\/mindbacklog.com\/blog","https:\/\/facebook.com"]}]}},"_links":{"self":[{"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/posts\/17245","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/comments?post=17245"}],"version-history":[{"count":1,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/posts\/17245\/revisions"}],"predecessor-version":[{"id":17297,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/posts\/17245\/revisions\/17297"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/media\/17214"}],"wp:attachment":[{"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/media?parent=17245"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/categories?post=17245"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mindbacklog.com\/blog\/wp-json\/wp\/v2\/tags?post=17245"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}