but is were going to make the memorys portable.. we need to make the things they are pointing to portable also..
It would be like trying to accomplish something as a human but all your reference material is always in a different format, it would be maddening.
Only it's not read by agents, and largely ignored.
From Anthropic's recent self-congratulatory article:
---start quote ---
Injected memories use up valuable tokens, and an incorrect note can be carried into every session. Loading a note also doesn’t guarantee that Claude acts on it: our documentation on Claude Code warns that longer instruction files reduce adherence
...
It loads only the first 200 lines or 25 KB of MEMORY.md
https://www.anthropic.com/research/components-of-agent-memor...
--- end quote ---
This has the benefit of being something you can easily read over every now and then to make sure the model hasn't baked in some random comment you made about a specific circumstance a month ago and made a weird religion out of it.
“Oh damn look its recommending something that looks like hexagonal architecture. I guess hexagonal is a really good - hey wait a second …”
Memory just ensures there is a fairly high level of drift and inaccuracy in your context. Unless YOU are manually curating it.
Its similar to wiki systems where your agent produces tons of documentation and decision records, etc. Its a bunch of assertions about your codebase that you aren’t vetting and which is at most 90% correct. Thats good enough for a feature or bug fix that you can validate with tests but for the love of god throw the details away. You don’t want to codify that. It’s polluting the context and gimping the model.
The best version of memory I've experienced is when I give my agent a memory directory and just let it do what it wants in there, with minimal rules on my end.
Index it all. Embed it all. Give your agents the ability to query it all. Eval different configurations to figure out what works best for you.
The sections, points, ideas are by me :)