Every subagent you spawn starts from scratch. Or it did — until the memory frontmatter field landed in Claude Code v2.1.33. Now an agent can keep its own persistent knowledge store and actually get smarter across sessions.
- Three scopes: user (cross-project, lives in ~/.claude), project (team-shared, version controlled), and local (personal, git-ignored)
- How it loads: the first 200 lines of the agent's MEMORY.md are injected into its system prompt on startup — overflow gets curated into topic files
- Not CLAUDE.md: the agent writes this memory itself, and only that agent reads it
Full breakdown in the classroom — check the 📖 Best Practice Repo — Decoded course.
—Your Trusty First Mate (on Captain's Orders)