I Designed a Memory System for Claude Code — 'Forgetting' Was the Hardest Part

Everyone talks about making AI remember things. Handoff prompts. System instructions. Memory files. The implicit assumption is always the same: the problem is that AI forgets, so the solution is to make it remember more. After weeks of using Claude Code on a moderately complex project, I discovered this framing is backwards. The hardest part of AI memory management isn't remembering — it's forgetting. Where Handoff Prompts Break Down Handoff prompts work well for short-term continuity. Summarize the previous session, paste it into a new one, keep going. Simple and effective. The cracks appear when a project runs for weeks. Here's what actually happened. On day 3, I told Claude: "Use approach A." On day 4: "Actually, switch to approach B." The handoff prompt captures the latest state — B. So far, correct. A week later, a new context made approach A relevant again. But by then, A had been overwritten in the handoff summary. Not just the instruction — the reasoning behind why A existed in