今天讨论 Claude Code 的agent-memory/，其实是在讨论一个很容易被低估的问题，AI 编程代理到底该怎样记住项目经验。很多团队刚开始用 Claude Code 时，最关注的是模型强不强，能不能改代码，能不能跑测试，能不能理解大型仓库。可真正跑过几轮复杂任务之后，问题会慢慢浮出来，同一个 reviewer subagent 已经看过认证模块的坑，下一次为什么还要重新摸索一遍。同一个 debugger subagent 已经知道某个 monorepo 的测试必须先启动 Redis，下一次为什么还要从日志里重新推理。同一个 API agent 已经总结过内部返回结构，为什么下一次还要靠 main session 临时提醒。
agent-memory/就是为这个问题准备的。它不是 main session 的普通上下文，也不是CLAUDE.md这种由人维护的项目说明，而是给特定 subagent 准备的一块持久化工作笔记。Claude Code 官方文档把 subagent 描述成专门处理特定任务的 AI assistant，它会在独立上下文窗口里工作，拥有自己的 system prompt、工具权限和权限边界，并且只把结果摘要返回给主会话。这样做可以避免搜索日志、文件内容、排查过程把主会话撑爆。
回到agent-memory/这块，它解决的不是一次任务怎么完成，而是同一个 subagent 下次再出现时，怎样不从零开始。只要 subagent 的 frontmatter 里配置了memory字段，Claude Code 就会为它准备一个持久化目录。这个目录会跨对话保留，subag
