Cómo mantener el contexto entre sesiones de IA

Cada sesión de un agente de programación comienza vacía. Claude Code lo dice en su propia documentación: cada sesión arranca con una ventana de contexto nueva. La herramienta no recuerda nada de lo que le dijiste ayer, a menos que algo externo a la conversación lo haya arrastrado hacia adelante. Por eso, saber cómo mantener el contexto entre sesiones de IA no es un truco único: es saber a cuál de las cuatro capas pertenece cada fragmento de contexto y colocarlo ahí antes de que termine la sesión.

Esta guía recorre las cuatro capas en orden: los archivos de instrucciones que la herramienta lee al iniciar, las notas que la herramienta escribe para sí misma, la reanudación de sesiones y el registro de trabajo compartido que ninguna de las tres anteriores ofrece. Las tres primeras son funciones de Claude Code, Codex y Gemini CLI. La cuarta es donde encaja Sharkly, porque una Task que reúne el objetivo, la conversación, las ejecuciones y la aceptación es la única capa que puede leer una segunda persona. Si todavía estás decidiendo entre conversar y asignar, nuestra guía para conversar con un agente de IA o asignar una Task es la pieza complementaria.

TL;DR

El contexto sobrevive a una sesión en cuatro lugares. Los archivos de instrucciones (CLAUDE.md, AGENTS.md, GEMINI.md) contienen las reglas que la herramienta debe mantener siempre. La memoria automática recoge las correcciones y preferencias que la herramienta aprendió. La reanudación de sesiones mantiene una conversación para una persona en una máquina. El registro de trabajo, es decir, una Task con su descripción, sus comentarios y su registro de ejecución, recoge lo que se decidió, lo que se ejecutó y lo que una persona aceptó, y es la única capa que se comparte. Coloca cada tipo de contexto en su capa y la ventana de contexto nueva dejará de ser una pérdida.

Capa 1: Archivos de instrucciones que la herramienta lee al iniciar

Los archivos de instrucciones son contexto que escribes una sola vez y que la herramienta carga en cada sesión. Cada CLI importante tiene el suyo, y todos se resuelven de forma parecida.

Dos hábitos mantienen útil esta capa. Mantén los archivos cortos: la guía de Claude Code apunta a menos de 200 líneas por archivo, porque la adherencia disminuye a medida que el archivo crece. Y escribe los hechos que de otro modo tendrías que volver a explicar, como los comandos de compilación, las convenciones y la regla que escribiste en el chat la sesión pasada. Si un repositorio ya tiene un AGENTS.md, un CLAUDE.md que solo contenga @AGENTS.md lo importa, de modo que ambas herramientas leen una única fuente. Todo lo que hay en esta capa es contexto, no imposición; la documentación de memoria de Claude Code deja claro que lo que bloquea una acción es un hook, no una instrucción.

Capa 2: Notas que la herramienta escribe para sí misma

La memoria automática de Claude Code es la capa de cuya existencia la gente se olvida. Mientras trabaja, Claude guarda notas sobre tu rol y tus preferencias, las correcciones que le das, el contexto del proyecto que no puede deducir del código y dónde encontrar cosas fuera del repositorio. Se almacenan en ~/.claude/projects/<project>/memory/, indexadas por un MEMORY.md cuyas primeras 200 líneas o 25 KB se cargan al inicio de cada sesión. Los archivos de temas se cargan bajo demanda.

Tres límites importan. La memoria automática es por repositorio y se comparte entre worktrees. Es local a la máquina, así que las notas de tu escritorio no existen en tu portátil. Y sobrevive a /compact, porque la compactación reescribe la conversación, no los archivos del disco. Para ver lo que se guardó, ejecuta /memory; para desactivarla, pon autoMemoryEnabled en false o exporta CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

Usa esta capa para ese tipo de cosas que dices una vez y esperas que se mantengan: «usa siempre pnpm», «las pruebas de la API necesitan un Redis local». No confíes en ella para decisiones que necesita un compañero de equipo; es solo tuya.

Capa 3: Reanudación de sesiones

A veces el contexto que necesitas es la propia conversación. Claude Code conserva las sesiones en disco: claude --continue reabre la conversación más reciente del directorio actual, claude --resume <id-or-name> reabre una concreta, y --fork-session crea un nuevo ID de sesión para que puedas ramificar desde un punto de control sin sobrescribirlo. Renombra una sesión con /rename antes de hacer /clear para poder encontrarla de nuevo. Codex ofrece codex resume para reabrir un chat reciente del repositorio actual.

La reanudación tiene un costo. Cada solicitud lleva la conversación completa, así que una sesión de larga duración consume más para una pregunta de una línea que una sesión nueva. /compact con una instrucción de enfoque, como /compact Focus on the migration plan, cambia detalle por espacio. Lo que sobrevive a la compactación es el resumen más lo que recarguen los archivos de instrucciones; cualquier cosa dada solo en la conversación y no resumida se pierde. Trata la reanudación como un puente para cruzar una pausa del almuerzo, no como la memoria del equipo.

Capa 4: El registro de trabajo

Ninguna de las tres primeras capas responde a la pregunta que un compañero de equipo hace el jueves: ¿qué hizo el agente el martes, por qué, y quién lo aceptó? Los archivos de instrucciones contienen reglas. La memoria automática contiene las preferencias de una persona. Una sesión reanudada contiene la conversación de una persona en una máquina. La decisión, la ejecución y la aceptación necesitan un registro compartido, y ese registro es una Task.

En Sharkly, una ejecución respaldada por una Task incluye el título y la descripción de la Task, los comentarios recientes y el comentario que desencadenó la ejecución, las instrucciones y las Skills del Agent, y los repositorios configurados para la Task. Eso es el traspaso de contexto: la siguiente ejecución parte de la Task, no de la memoria de la sesión anterior. El progreso, los eventos de traza y el resultado vuelven a la Task, y el registro de ejecución anota por qué se puso en cola una ejecución, cuándo empezó y terminó, las llamadas a herramientas, la fuente del desencadenante y los detalles del fallo.

Dos reglas de la documentación del producto deciden dónde va cada cosa, y ambas son reglas de límites más que funciones. Las sesiones de Agent Chat independientes pertenecen a quien las creó y los demás miembros no obtienen acceso; si el equipo necesita una conclusión, cópiala en la descripción de la Task o en un comentario. Y el chat del Agent en una Task no es un comentario: no aparece en Activity, así que una decisión tomada ahí es invisible a menos que alguien la escriba. Nuestro recorrido por la gestión de proyectos con Claude Code muestra la Task llevando un cambio desde el issue hasta la revisión.

Vale la pena citar una distinción más, porque es exactamente la trampa de la que trata este artículo. Un Crew puede habilitar la reutilización compartida del directorio de Tasks, de modo que la ejecución de un miembro posterior del Agent hereda los cambios locales del miembro anterior en la misma Computer. Esa configuración comparte el estado del sistema de archivos, no la sesión del proveedor del Agent anterior. Los archivos se transmiten; la conversación del modelo, no. Si el segundo Agent necesita el razonamiento del primero, tiene que estar en la Task.

Colocar cada tipo de contexto en su capa

Las Skills se ganan su propia fila. Una Skill empaqueta instrucciones reutilizables y archivos de apoyo para una guía que debe aplicarse repetidamente, y una Skill descubierta en un directorio de Runtime local puede importarse a la organización para que deje de vivir en un solo portátil. Nuestra guía sobre las Skills en Sharkly cubre el ámbito y el binding, y qué es una skill de agente de programación cubre el formato del archivo.

Usa archivos de instrucciones y memoria automática cuando el contexto trate sobre cómo trabajas. Usa una Task cuando el contexto trate sobre lo que el equipo está construyendo y otra persona pueda necesitar leerlo. Sharkly no sustituye a Claude Code, Codex ni otras herramientas de ejecución; añade el registro compartido que esas herramientas no conservan.

Preguntas frecuentes

¿/compact pierde mi CLAUDE.md? No. El CLAUDE.md de la raíz del proyecto se vuelve a leer desde el disco después de la compactación. Las instrucciones dadas solo en la conversación pueden perderse; llévalas al archivo.

¿La memoria automática se comparte con mi equipo? No. Se almacena en tu directorio home, por repositorio, y nunca se sincroniza. El contexto visible para el equipo pertenece a un archivo de instrucciones versionado o a una Task.

¿Puede un Agent de Sharkly recordar una ejecución anterior? Recibe la Task, sus comentarios recientes y el comentario desencadenante en cada ejecución, que es la forma duradera de recordar. No recibe la conversación privada de la ejecución anterior. Consulta Agents en Sharkly para saber qué incluye una ejecución.

¿Y los servidores de memoria MCP? Añaden un quinto almacén que el modelo puede consultar, útil para el recuerdo estructural de una base de código. Aun así no registran quién aceptó un cambio, así que combínalos con un registro de trabajo en lugar de reemplazarlo.