# Memoria {#memory}

> Guarda conocimiento útil del proyecto en Markdown para reutilizarlo en futuras sesiones.

La memoria de Clarvis conserva comandos útiles, decisiones de arquitectura, errores recurrentes y los motivos de una solución provisional en archivos Markdown. Puedes leerlos y editarlos. El almacenamiento por defecto no necesita una base de datos vectorial ni embeddings.

## Distingue memoria, sesiones y contexto {#distinguish-memory-from-sessions-and-context}

- El **historial de sesión** es el registro duradero de lo que dijeron e hicieron las personas y los agentes.
- El **contexto del modelo** es el conjunto limitado que se envía en una llamada y que puede compactarse.
- La **memoria** es conocimiento seleccionado para reutilizarlo entre ejecuciones del mismo espacio de trabajo.

La memoria no copia todas las conversaciones. La mayoría de las ejecuciones no necesitan actualizarla. Los detalles se guardan en archivos `MEMORY.md`, agrupados por resúmenes temáticos. `PROFILE.md` es el índice principal del proyecto.

```text
<workspace>/.clarvis/memory/
├── PROFILE.md
└── build/
    ├── TOPIC.md
    └── bun/
        └── MEMORY.md
```

## Activa la memoria {#turn-memory-on}

Abre `/settings/memory`, elige el ámbito global o del espacio de trabajo, crea el bloque de memoria y selecciona el modelo que extraerá el conocimiento duradero. Guarda el cambio para futuras ejecuciones. La fila de sesión permite activar o desactivar temporalmente la memoria configurada sin reescribir los ajustes.

La memoria necesita un modelo de extracción válido. Usa el modelo específico si está configurado; en caso contrario, el modelo por defecto efectivo. Si ninguno puede resolverse, conserva la configuración pero avisa de que no puede aprender.

## Cómo aprende de una ejecución {#follow-how-one-run-learns}

Al comenzar, Clarvis añade el resumen limitado de `PROFILE.md` al contexto del agente. Los agentes con acceso a memoria pueden buscar y leer documentos más detallados. El agente principal puede actualizarla mediante las herramientas protegidas de memoria; los subagentes tienen acceso de lectura, pero no pueden concederse permiso de escritura.

Al terminar, Clarvis guarda un trabajo en segundo plano para revisar la tarea, el resultado y un conjunto limitado de pruebas de herramientas. Solo actualiza la memoria si hay algo que merezca conservarse. Puedes iniciar otra tarea sin esperar.

## Indica qué merece recordarse {#tell-clarvis-what-deserves-a-note}

Añade instrucciones en Markdown en uno o ambos lugares:

| Archivo                                 | Ámbito                       | ¿Se comparte?           |
| --------------------------------------- | ---------------------------- | ----------------------- |
| `~/.clarvis/memory-policy.md`           | Tus preferencias generales   | No                      |
| `<workspace>/.clarvis/memory-policy.md` | Las necesidades del proyecto | Puedes guardarlo en Git |

Las dos políticas se combinan, primero la global. Describe **qué** información resulta útil, sin intentar sustituir la estructura de la wiki:

```md
Record the exact command that fixed a build and explain why it worked.
Do not retain customer data, temporary credentials, or personal shell aliases.
```

Los cambios de política se aplican en el siguiente indexado, sin reiniciar.

## Mantén la memoria accesible y segura {#keep-memory-inspectable-and-safe}

El almacenamiento de archivos por defecto está dentro de los datos de Clarvis del espacio de trabajo y se puede leer directamente como Markdown. Los secretos se ocultan en las capturas limitadas de ejecución antes del indexado. Aun así, la política importa: no pidas conservar datos sensibles que no deban formar parte del conocimiento duradero del proyecto.

Clarvis también admite un proveedor de memoria MCP o de un plugin. Ese proveedor controla su almacenamiento y capacidades. Nunca se envían escrituras de indexado a un proveedor de solo lectura. Al cambiar de proveedor, las escrituras en cola no se reproducen en el nuevo almacenamiento.

## Consulta también {#see-also}

- [Cómo funciona Clarvis](/es-ES/explanation/how-clarvis-works)
- [Configuración](/es-ES/reference/configuration#prompt-and-memory-control)
- [Uso diario](/es-ES/guide/daily-use)
- [Seguridad y control](/es-ES/guide/safety)

---

[HTML canónico](https://clarvis.dev/es-ES/guide/memory)

[Índice de documentación](https://clarvis.dev/es-ES/llms.txt)