Back to Claude Code hub
BEGINNERsnapshot-basedVerified 2026-03-31comparison

CLAUDE.md vs MEMORY.md

Two persistence layers with different jobs

A clear comparison between repository-scoped collaboration instructions and persistent memory files intended to survive across future conversations.

CLAUDE.md is for the current project

It captures how this repo wants to be worked in: conventions, commands, architecture, and collaboration rules.

MEMORY.md is for future conversations

It indexes durable user, project, feedback, or reference facts that may matter later, beyond the current task or session.

If it only matters right now, it probably belongs in a plan or task

The memory system itself warns against using memory as a dumping ground for execution state.

Learn next

These guides are adjacent to the current topic and make the learning path easier to follow.