Skip to content

Instantly share code, notes, and snippets.

@karthiks
Created March 21, 2026 09:54
Show Gist options
  • Select an option

  • Save karthiks/8e95c2d15863646a577cced2282e44ce to your computer and use it in GitHub Desktop.

Select an option

Save karthiks/8e95c2d15863646a577cced2282e44ce to your computer and use it in GitHub Desktop.
The Two Pillars of Memory in Claude Code

The Two Pillars of Memory

Claude Code uses a dual-memory system to balance your explicit instructions with its own learned observations.

Feature CLAUDE.md (Static Memory) MEMORY.md (Auto Memory)
Who Writes It? You (Manual) Claude (Automated)
Content "Project rules, architecture, tech stack." "Patterns, ""gotchas,"" and user preferences."
Location Your Project Root (git-tracked). ~/.claude/projects/ (system-local).
Persistence Permanent and shared with your team. Local to your machine; session-dependent.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment