MemoryLake
Volver a todos los artículos
Tutorial31 de julio de 2026·7 min de lectura

Por qué el agente de Zed olvida el contexto de tu proyecto y cómo solucionarlo (2026)

Zed es rápido, y su Agent Panel te permite ejecutar varios agentes a la vez, que es exactamente cuando la amnesia empieza a doler. El hilo uno descubre por qué la migración debe ejecutarse antes del backfill. El hilo dos, abierto diez minutos después, nunca ha oído hablar de ninguna de las dos cosas. Vuelves a mencionar con `@` los mismos cuatro archivos, reafirmas la misma restricción y esperas haberlo expresado de la misma manera dos veces.

La respuesta directa: esto no es un defecto, es el diseño de Zed. Cada hilo de agente lleva su propio contexto e historial de conversación, y el contexto no se transfiere entre hilos automáticamente. Zed tampoco incluye una función de memoria lista para usar; el camino previsto es componer una a través de MCP, configurada bajo la clave `context_servers`. Zed construyó el conector; tú proporcionas la memoria.

Esta guía cubre los cuatro mecanismos que hacen que el agente olvide, qué cubren y qué no las herramientas integradas, y cómo conectar una memoria que persista a través de hilos, reinicios y repositorios.

Por qué el agente de Zed olvida

Cada hilo comienza con su propio contexto

El Agent Panel admite múltiples hilos de agentes concurrentes además de Terminal Threads para trabajo de CLI y TUI, y cada uno tiene un contexto e historial independientes. Esa independencia es lo que hace que los agentes paralelos sean utilizables, y significa que nada de lo que hayas establecido en un hilo es visible en el siguiente. Puedes mencionar explícitamente con @ un hilo anterior, y "New From Summary" inicia un nuevo hilo con un resumen de la conversación actual, pero ambos son actos manuales que debes recordar realizar.

La compactación gestiona el espacio, no el conocimiento

Zed compacta automáticamente los hilos largos de los agentes a medida que se acercan a un umbral de tokens configurado, resumiendo los mensajes anteriores y dejando una entrada "Context Compacted" que puedes inspeccionar; /compact lo hace bajo demanda, y agent.auto_compact controla el comportamiento. Esto es una buena ingeniería para sesiones largas, y es fácil confundirlo con memoria. La compactación acorta lo que ya está en el hilo. No mueve nada fuera del hilo, y el resumen muere con el hilo.

.rules es instrucción, no acumulación

Zed lee un archivo de reglas del proyecto desde la raíz de tu árbol de trabajo (worktree) y lo incluye automáticamente en cada interacción del Agent Panel, verificando una lista de prioridad de nombres de archivo — .rules, .cursorrules, .windsurfrules, .clinerules, .github/copilot-instructions.md, AGENT.md, AGENTS.md, CLAUDE.md, GEMINI.md — y utilizando la primera coincidencia. Eso es realmente útil, y la razón por la que tus convenciones sobreviven a un nuevo hilo.

But un archivo de reglas es algo que tú escribes, no algo que el agente completa. Nada de lo que un agente descubra a las 4 p. m. aparecerá allí a las 5 p. m. Si se deja solo, se vuelve obsoleto; si se mantiene con diligencia, se convierte en un muro de texto que cuesta tokens en cada interacción y entierra los diez datos que realmente importan.

La memoria en Zed es algo que tú compones

Zed admite servidores MCP bajo context_servers, instalables como extensiones o configurados directamente como servidores locales o remotos con argumentos de comando o URL y encabezados de autenticación opcionales, exponiendo herramientas (Tools) y prompts de MCP al agente, con permisos gobernados por agent.tool_permissions.default. Esa es la ruta oficialmente aprobada para la persistencia: conecta un servidor de memoria y el agente podrá leer y escribir conocimientos que sobrevivan al hilo. Nada viene preconfigurado.

Lo que los usuarios de Zed intentan primero

Mencionar con @ hilos anteriores

Preciso y útil cuando recuerdas qué hilo tenía la respuesta. Deja de escalar en el momento en que tienes treinta hilos y no tienes idea de cuál contenía la decisión sobre los reintentos.

New From Summary

Mejor que empezar de cero, pero es una transferencia con pérdida de información por naturaleza: un resumen mantiene la forma de la conversación y descarta los detalles específicos que resultan ser importantes (la razón exacta por la que existe una solución alternativa, la versión donde cambió el comportamiento).

Un archivo .rules más grande

La respuesta más común, y la que tiene un límite estricto. Cada interacción paga por su longitud total, las actualizaciones dependen de la disciplina humana y no puede expresar nada que dependa del tiempo. Es un documento informativo que finge ser una base de conocimientos, el mismo límite descrito en por qué Claude Code olvida el contexto del proyecto.

Un archivo markdown de borrador (scratchpad) en el repositorio

Los equipos mantienen un notes.md y lo mencionan con @. Esto funciona sorprendentemente bien por un tiempo, luego se convierte en un registro de solo adición (append-only) que nadie depura, con entradas contradictorias y sin noción de cuál es la actual.

La solución: Conectar un servidor de memoria persistente en Zed

Dado que Zed espera que la memoria llegue a través de MCP, la solución limpia es darle una capa de memoria diseñada para el trabajo en lugar de un archivo que finge serlo. MemoryLake almacena tu arquitectura, decisiones y convenciones una sola vez; cada hilo —y cualquier otro agente que utilices— lee de la misma fuente.

Paso 1: Crear una clave API

Genera una clave y realiza tu primera solicitud en unos 30 segundos.

Crear una clave API de MemoryLake
Crear una clave API de MemoryLake

Paso 2: Sube tus primeras memorias

Arrastra los documentos, imágenes y archivos que contienen el contexto real de tu proyecto: notas de arquitectura, ADR, runbooks, especificaciones de API, informes de incidentes y las decisiones que tus hilos siguen deduciendo una y otra vez.

Sube tus primeras memorias a MemoryLake
Sube tus primeras memorias a MemoryLake

Paso 3: Conecta tu IA y agentes

Dale a Claude, Codex, OpenClaw y a tus otros agentes acceso a esa memoria a través de MCP o la API; en el caso de Zed, como un servidor de contexto junto a tus otras entradas de MCP, con los permisos de herramientas configurados de la manera que prefiera tu equipo. Cada nuevo hilo de agente se abrirá con el proyecto ya conocido en lugar de vacío. Si también trabajas en la terminal, añadir memoria a Claude Code y configurar la memoria cruzada entre IA con MCP cubren la misma capa desde otros clientes.

Conecta tu IA y agentes a través de MCP
Conecta tu IA y agentes a través de MCP

Qué cambia esto en la práctica

Los agentes paralelos multiplican el costo de olvidar. Restablecer el contexto cuesta, por ejemplo, 1,500 tokens y dos minutos por hilo; ejecuta seis hilos al día y eso equivale a 9,000 tokens y doce minutos diarios dedicados al preámbulo, unos 270,000 tokens al mes, antes de que nadie escriba código. Un archivo .rules grande no elimina ese costo, lo hace incondicional: pagas por todo el archivo en cada hilo, incluidos aquellos que solo necesitaban dos líneas del mismo.

La diferencia de comportamiento es aún mayor. Cuando los hilos comparten memoria, el hilo dos conoce la restricción de orden de migración que descubrió el hilo uno, y no intenta "corregirla" de manera inútil. Ese es el mismo tipo de problema que la memoria multiagente, solo que dentro de un único editor, y es la razón por la que los equipos que ejecutan agentes concurrentes sienten esto antes que los demás.

Buenas prácticas para la memoria del agente de Zed

Separa las instrucciones del conocimiento

Mantén .rules para definir cómo debe comportarse el agente (estilo, expectativas de revisión, rutas prohibidas) y mantén los datos sobre tu sistema en la memoria. Las reglas se mantienen lo suficientemente cortas como para justificar su carga cada vez; el conocimiento crece sin penalizar cada interacción.

Escribe en la memoria al final de un hilo, no al principio

El resultado valioso de un hilo largo suele ser una o dos frases: qué se decidió y por qué. Haz que guardar eso sea un hábito al cerrar un hilo, o el siguiente hilo pagará por volver a descubrirlo. La compactación no lo hará por ti: resume dentro del hilo y desaparece con él.

Depura y pon fecha a tus entradas

Registra cuándo se tomó una decisión y reemplaza los datos obsoletos en lugar de apilar nuevos junto a ellos. Los agentes confían en lo que leen, por lo que una entrada desactualizada hace más daño que una faltante; la misma disciplina que evita que un borrador se convierta en un registro de contradicciones.

Conclusión

El agente de Zed olvida el contexto de tu proyecto porque los hilos están aislados por diseño, la compactación opera dentro de un hilo en lugar de más allá de él, .rules es un archivo de instrucciones estático y la memoria es explícitamente algo que conectas a través de MCP en lugar de algo que viene integrado. Nada de eso es un defecto en un editor rápido con agentes paralelos; es una división del trabajo.

La división solo funciona una vez que cumples con tu parte. Coloca la arquitectura, las decisiones y las convenciones en una capa de memoria, conéctala como un servidor de contexto, y la velocidad por la que elegiste Zed dejará de desperdiciarse en volver a explicar lo que el último hilo ya sabía.

Preguntas frecuentes

¿Tiene Zed memoria de agente integrada?

No como una función lista para usar. Zed lee un archivo de reglas del proyecto en cada interacción y admite servidores MCP bajo context_servers, que es la ruta prevista para la persistencia; pero la memoria entre hilos es algo que tú compones en lugar de simplemente activar.

¿Por qué el contexto no se transfiere entre los hilos del agente de Zed?

Cada hilo de agente —y cada Terminal Thread— mantiene su propio contexto e historial, que es lo que hace que ejecutar varios a la vez sea viable. Puedes mencionar con @ un hilo anterior o usar "New From Summary" para transferir algo manualmente, pero no hay una transferencia automática.

¿No es la compactación automática lo mismo que la memoria?

No. La compactación resume los mensajes anteriores dentro de un hilo a medida que se acerca a un umbral de tokens, dejando una entrada "Context Compacted", con /compact para ejecuciones manuales y agent.auto_compact para configurarlo. Mantiene un hilo largo manejable; no preserva nada después de que el hilo termina.

¿Qué nombres de archivo de reglas acepta Zed?

Verifica una lista de prioridad en la raíz del árbol de trabajo (worktree) — .rules, .cursorrules, .windsurfrules, .clinerules, .github/copilot-instructions.md, AGENT.md, AGENTS.md, CLAUDE.md, GEMINI.md — y utiliza la primera coincidencia, incluyéndola automáticamente en las interacciones del Agent Panel. Es conveniente si estás migrando desde otra herramienta, pero sigue siendo un archivo de instrucciones estático en lugar de una memoria.

¿Puede una sola memoria servir para Zed y mis otros agentes?

Sí. Debido a que la conexión es MCP, la misma capa de memoria puede ser leída por el agente de Zed, un agente de terminal y un asistente de chat, por lo que una decisión registrada en uno está disponible en los demás en lugar de tener que deducirse de nuevo.