Start with the catalog
A library is useful because it does not drop every book on your desk. claude-mem uses progressive disclosure, which means it reveals information in layers. The agent sees a compact index first, then opens detail only when the current task makes it worthwhile.
Context is an attention budget
A context window measures how much text a model can receive, not how much it can use equally well. Context rot is the loss of focus that appears when useful instructions are surrounded by too much unrelated history.
Progressive disclosure protects that attention budget. It spends a little on the catalog, more on a promising timeline, and the most only on memories the agent has already judged relevant.
Provide the map. Let the agent choose the path.
Sometimes the memory is enough
The File Read Gate applies the same idea to source code. Before a large file is read, claude-mem can show a compact timeline of earlier work on that file. The agent may already have enough orientation, or it can fetch a few observations before paying to read the source.
Documented worked example. Actual savings depend on the file and the memories available.
Small files still pass through. If the map costs more than opening the drawer, claude-mem simply opens the drawer.