Por qué necesitás estas herramientas

Cuando armé el motor de contexto dinámico de nojau, la parte difícil nunca fue guardar información — fue decidir qué guardar y cómo recuperarla sin ruido. Engram te da 19 herramientas para resolver exactamente eso. No hace falta aprenderlas todas de entrada: acá están las que vas a usar el 90% del tiempo y para qué sirve cada una.

Lo básico: Guardar y buscar

tool: mem_save — Guardar lo importante

Esta es la que más vas a usar. Cada vez que terminás algo significativo:

{
  "title": "JWT auth middleware",
  "type": "decision",
  "content": "**What**: Replaced sessions with JWT\n**Why**: Needed stateless auth for scaling\n**Where**: src/middleware/auth.ts",
  "scope": "project"
}

Tipos disponibles: decision, architecture, bugfix, pattern, config, discovery, learning.

Si trabajás en algo que evoluciona (ej: arquitectura), usá topic_key para que actualice la misma memoria en vez de crear una nueva.

tool: mem_search — Buscar en memoria

{ "query": "JWT auth", "project": "mi-proyecto" }

Te devuelve todas las memorias que matchean, ordenadas por relevancia. Si tenés relaciones juzgadas entre memorias, las ves ahí mismo.

tool: mem_get_observation — Ver una memoria completa

{ "id": 42 }

Después de buscar, agarrás el ID y pedís el contenido completo.

---

Contexto rápido: lo que pasó en sesiones anteriores

tool: mem_context

Te muestra las últimas sesiones con sus memorias y prompts. Útil para arrancar una nueva sesión y recordar qué se hizo.

tool: mem_timeline

Drill-down cronológico. Después de buscar algo, pedís contexto alrededor — qué otras memorias existían en esa misma sesión.

tool: mem_stats

Un resumen rápido: cuántas sesiones, cuántas memorias, cuántos proyectos.

---

El ciclo de vida de una sesión

tool: mem_session_start

Registrá el inicio de una sesión. Útil si trabajás en algo largo y querés trackear progreso.

tool: mem_session_summary

Al cerrar la sesión, guardás un resumen estructurado:

## Goal
[Qué estábamos haciendo]

## Instructions
[Preferencias o constraints descubiertos]

## Discoveries
- [Aprendizaje 1]
- [Aprendizaje 2]

## Accomplished
- ✅ [Tarea completada]

## Next Steps
[Qué falta por hacer]

tool: mem_session_end

Cerrá la sesión con un resumen opcional.

---

Mantenimiento y calidad

tool: mem_update

Actualizá una memoria existente. Cambiá el título, contenido, tipo o topic.

tool: mem_delete

Borrá una memoria. Por defecto es soft-delete (se puede recuperar); poné hard_delete: true si querés eliminarlo permanentemente.

tool: mem_capture_passive

Pasale texto que contenga secciones ## Key Learnings: y automáticamente guarda cada punto como una memoria separada. Los duplicados se saltean.

---

Gestión de proyectos

tool: mem_current_project

Detectá en qué proyecto estás trabajando. Devuelve el nombre, source y path. Nunca falla — si hay ambigüedad, te devuelve opciones para resolver.

tool: mem_merge_projects

Admin tool. Uní múltiples variantes de nombre de proyecto en uno solo. Ej: mi-proyecto + mi-proyecto-2 → mi-proyecto.

tool: mem_doctor

Diagnosticá el sistema. Útil para troubleshooting cuando algo no funciona como esperás.

---

Avanzado: comparar y juzgar memorias

Esta es la parte más interesante de Engram — y la que más se parece al trabajo real de curar contexto para un chat con IA en producción: no todo lo que se guarda merece el mismo peso, y a veces una memoria nueva contradice a una vieja.

tool: mem_judge

Cuando guardás algo nuevo, Engram puede detectar que conflictúa con algo existente. Te devuelve candidates[] y te pide que juzgues la relación:

• related — están conectadas
• compatible — coexisten sin problemas
• scoped — aplican a contextos diferentes
• conflicts_with — una contradice a la otra
• supersedes — la nueva reemplaza a la anterior
• not_conflict — no hay conflicto real

tool: mem_compare

Comparás dos memorias específicas que elegís vos, no necesariamente relacionadas automáticamente. Útil para revisión proactiva.

---

Tipos que podés usar

Tipo	Cuándo usarlo
decision	Decisiones de arquitectura o diseño
architecture	Patrones estructurales
bugfix	Bugs que corregiste y cómo
pattern	Patterns que descubriste
config	Configuraciones importantes
discovery	Descubrimientos no obvios
learning	Aprendizajes generales

---

Ejemplo rápido de sesión

1. mem_current_project → detecta "mi-proyecto"
2. mem_context → ve qué se hizo en sesiones anteriores
3. mem_save → "Fixed N+1 query in UserList"
4. mem_search → buscás algo que habías hecho antes
5. mem_session_summary → guardás resumen al cerrar

---

Post anterior: Memoria persistente para agentes de IA — intro a Engram y por qué me sirve.

---

Este tipo de curación de contexto — decidir qué persiste, qué se descarta y qué reemplaza a qué — es la misma disciplina que aplico diseñando sistemas de RAG en producción. Si tu equipo necesita a alguien que piense así el problema, hablemos: LinkedIn · andeveling@gmail.com