Answer: A CLAUDE.md file should be short and signal-dense, under roughly 200 lines, and include commands, conventions, architecture in three sentences, hard constraints, and known gotchas. It should not include full API documentation, changelogs or history, anything obvious from the file tree, or aspirational rules the team does not actually follow. Status: Confirmed Entry: tool/claude-apps/memory-and-context/what-to-put-in-claude-md Revision: 1 Digest: sha256:4f88dc4a3243319a (changes whenever the content changes) Timeline: Created: 2026-11-13T02:59:34Z Last changed: 2026-11-13T02:59:34Z Last verified: 2026-11-20T12:06:43Z Next check: 2026-11-21T12:06:43Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Unit | Source | As of recommended length | under roughly 200 lines | lines | [1] | 2026-11-20 worth including | Commands — how to build, test, lint, and run locally. | | [1] | 2026-11-20 conventions | Conventions — naming, error handling, file layout, and "we use X, not Y" decisions. | | [1] | 2026-11-20 architecture | Architecture in three sentences | | [1] | 2026-11-20 hard constraints | Hard constraints | | [1] | 2026-11-20 known gotchas | Known gotchas — the issues every new engineer trips on. | | [1] | 2026-11-20 not worth including | Full API documentation (Claude can read the code directly). | | [1] | 2026-11-20 aspirational rules | Aspirational rules the team does not actually follow. | | [1] | 2026-11-20 Sources: [1] Anthropic. "Give Claude context: CLAUDE.md and better prompts | Claude Help Center". https://support.claude.com/en/articles/14553240-give-claude-context-claude-md-and-better-prompts Role: primary. Accessed: 2026-11-20T12:06:43Z Quote: "Aim for a file that is short and signal-dense — under roughly 200 lines." (Supports: recommended length) Quote: "Worth including: Commands — how to build, test, lint, and run locally." (Supports: worth including) Quote: "Conventions — naming, error handling, file layout, and "we use X, not Y" decisions." (Supports: conventions) Quote: "Architecture in three sentences — what the major pieces are and how they communicate." (Supports: architecture) Quote: "Hard constraints — for example, "never write to the production database from tests,"" (Supports: hard constraints) Quote: "Known gotchas — the issues every new engineer trips on." (Supports: known gotchas) Quote: "Not worth including: Full API documentation (Claude can read the code directly)." (Supports: not worth including) Quote: "Aspirational rules the team does not actually follow." (Supports: aspirational rules) Snapshot SHA-256: 4ec3a0367514f796ce185c88841ff00cd0febd3266196da4b8284eabe19c8c13 (captured 2026-11-13T02:59:33Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-13T02:59:34Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:06:43Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:06:43Z Last attempt: 2026-11-20T12:06:43Z Notes and limitations: Extracted automatically from a single official source (section "What actually belongs in it"). Related: https://latestn.com/tool/claude-apps/memory-and-context/when-rag-activates When does Claude automatically switch a project to RAG mode? https://latestn.com/tool/claude-apps/models/access-fable-models How do I access Claude Fable models on my plan? https://latestn.com/tool/claude-apps/models/adapt-to-new-model-personas How can I adapt to a new Claude model persona after my preferred model is deprecated? https://latestn.com/tool/claude-apps/memory-and-context/turn-memory-on-off-account How do I turn Claude's memory on or off for my account? https://latestn.com/tool/claude-apps/memory-and-context/turn-off-memory-single-chat How do I turn off memory for a single Claude chat? https://latestn.com/tool/claude-apps/memory-and-context/what-claude-doesnt-remember What does Claude not remember across chats? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T02:59:34Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-apps/memory-and-context/what-to-put-in-claude-md/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-apps/memory-and-context/what-to-put-in-claude-md POST: https://latestn.com/dispute/tool/claude-apps/memory-and-context/what-to-put-in-claude-md with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-apps/memory-and-context/what-to-put-in-claude-md?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). What should I include in a CLAUDE.md file for Claude Code? Revision 1, last verified 2026-11-20T12:06:43Z. https://latestn.com/tool/claude-apps/memory-and-context/what-to-put-in-claude-md (accessed 2026-11-21T10:05:02Z). @misc{LatestN_tool_claude_apps_memory_and_context_what_to_put_in_claude_md_r1, title = {What should I include in a CLAUDE.md file for Claude Code?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-apps/memory-and-context/what-to-put-in-claude-md}}, note = {Revision 1; digest sha256:4f88dc4a3243319a; last verified 2026-11-20T12:06:43Z; accessed 2026-11-21T10:05:02Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-apps/memory-and-context/what-to-put-in-claude-md