# Mejores prácticas de memoria
SUMMARY: Cómo estructurar memorias para un recall efectivo — categorías, claves, etiquetas, prioridades.

Mejores prácticas de memoria
La forma en que estructure las memorias determina cuán útiles son. Esta guía
cubre patrones para categorizar, etiquetar y priorizar memorias para que el LLM
pueda recuperar la información correcta en el momento adecuado.
Categorías: elija la más específica
| Categoría | Usar para | Ejemplo |
|----------|---------|---------|
|  | Nombre, rol, info de contacto |  |
|  | Gustos, disgustos, estilo de trabajo |  |
|  | Hechos verificables |  |
|  | Estado del proyecto, decisiones |  |
|  | Habilidades del usuario |  |
|  | Errores pasados a evitar |  |
|  | Contexto relevante para la sesión |  |
|  | Notas varias |  |
> [!TIP]
> En caso de duda, use  para información verificable y  para todo
> lo demás. No sobrecategorice — mejor un  claro que un 
> confuso.
Claves: identificadores significativos
El campo  es el identificador de la memoria. Use claves significativas y
estables:
Buenas claves:
- 
- 
- 
- 
Malas claves:
-  (no significativa)
-  (no descriptiva)
-  (la fecha no ayuda al recall)
Convenciones de nomenclatura de claves
-  (minúsculas con guiones bajos)
- Prefije con la categoría: , , 
- Use sustantivos descriptivos, no verbos
- Mantenga por debajo de 50 caracteres
Etiquetas: para búsqueda y filtrado
Las etiquetas permiten filtrado y búsqueda rápida. Añada 2-5 etiquetas por
memoria:
[CODE BLOCK]
Patrones de etiquetado
- Nombres de proyecto: , , 
- Temas: , , , 
- Estado: , , 
- Indicadores de prioridad: , 
> [!NOTE]
> Las etiquetas son insensibles a mayúsculas/minúsculas. Use minúsculas para
> consistencia.
Prioridades: sea realista
| Prioridad | Usar para | % de memorias |
|----------|---------|---------------|
|  | Identidad del usuario, info legal, decisiones irreversibles | 5% |
|  | Proyectos activos, preferencias importantes | 20% |
|  | La mayoría de hechos, notas, contexto | 65% |
|  | Efímera, bueno saberlo | 10% |
> [!WARNING]
> No marque todo como . Si todo es crítico, nada lo es. Reserve
>  para cosas que causarían un daño real si se olvidan.
Cuándo almacenar y cuándo no
Almacene siempre
- Identidad del usuario (nombre, email, rol)
- Preferencias a largo plazo
- Decisiones del proyecto y su justificación
- Errores pasados y lecciones aprendidas
- Compromisos adquiridos con el usuario
No almacene
- Estado transitorio (use variables en su lugar)
- Historial de conversación literal (lo gestiona el sistema de chat)
- Datos sensibles (contraseñas, API keys)
- Hechos fácilmente derivables (fecha actual, contenidos de archivos)
- Contexto efímero (use la categoría  con prioridad baja)
Actualizar memorias
POST  con la misma  +  actualiza la memoria existente:
[CODE BLOCK]
> [!TIP]
> Use claves estables para poder actualizar sin crear duplicados. El LLM debe
> volver a hacer POST con la misma clave a medida que la información cambia, no
> crear nuevas memorias.
Ciclo de vida de la memoria
[CODE BLOCK]
- Create: POST /memory con contexto completo
- Active: Recall frecuente, actualizar según sea necesario
- Stale: Aún relevante pero no usado activamente (¿bajar prioridad?)
- Archive: Establecer prioridad a , conservar como referencia histórica
- Delete: DELETE /memory/:id cuando ya no sea relevante
Limpieza periódica
[CODE BLOCK]
Patrón: herencia de memoria
Para contexto jerárquico (proyecto → subproyecto → tarea):
[CODE BLOCK]
El LLM puede entonces buscar  para encontrar todas las memorias
relacionadas.
Patrón: log de decisiones
Almacene decisiones con su justificación para que el LLM no las vuelva a
cuestionar:
[CODE BLOCK]
Patrón: evitar errores
Almacene errores con instrucciones específicas de prevención:
[CODE BLOCK]
Antipatrones a evitar
> [!WARNING]
> - Almacenar logs de conversación — lo gestiona el sistema de chat
> - Almacenar archivos completos — use script store o almacenamiento externo
> - Almacenar estado efímero — use variables
> - Almacenar secretos — use variables de entorno
> - Duplicar memorias — use claves estables
> - Sobreetiquetar — 2-5 etiquetas por memoria es lo ideal
> - Todo es crítico — sea realista con las prioridades
Próximos pasos
- API de Memory
- Agente LLM persistente
- Estrategia de etiquetado de memoria