{"version":"2.1.31","anchor":"persistent-agent-memory-system-gradual-rollout","canonical_anchor":"persistent-agent-memory-system-gradual-rollout","heading":"Persistent Agent Memory System [Gradual Rollout]","tier":null,"area":null,"scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.31\/e\/persistent-agent-memory-system-gradual-rollout","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.31","markdown":"### Persistent Agent Memory System [Gradual Rollout]\n\n**What**\n\nA comprehensive persistent memory system that lets Claude remember insights, patterns, and learnings across conversations, stored in MEMORY.md files within configurable directory scopes.\n\n**Usage**\n\nAgent memory is configured through a new interactive dialog accessible during onboarding or settings. Users choose one of:\n\n- **User scope** (`~\/.claude\/agent-memory\/`) -- general learnings across all projects\n- **Project scope** (`.claude\/agent-memory\/`) -- project-specific, shared via version control\n- **Local scope** (`.claude\/agent-memory-local\/`) -- project-specific, not checked into version control\n- **None** -- no persistent memory\n\n**Details**\n\n- Memory is stored in `MEMORY.md` files that are automatically loaded into the system prompt\n- Claude is instructed to organize memory semantically by topic, not chronologically\n- Records insights about problem constraints, strategies that worked or failed, and lessons learned\n- Claude proactively updates memory as it discovers useful patterns during work\n- MEMORY.md is truncated at 200 lines with a warning when exceeded, encouraging users to compact or reorganize\n- When MEMORY.md is empty, Claude is prompted to start recording learnings for future sessions\n- Can be disabled with `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` environment variable\n\n**Evidence**\n\nPersistent Agent Memory feature with configuration UI (search for `\"Persistent Agent Memory\"`, `\"Configure agent memory\"`, `\"Organize memory semantically by topic\"`, and `\"no persistent memory\"`). Gated by `tengu_oboe` feature flag (default `!1` = false)."}