Por qué necesitas estas herramientas

Engram te da 19 herramientas para trabajar con memorias. No necesitás aprenderlas todas de entrada — te voy a mostrar 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 ve right there.

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 chronological. 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é estabamos 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 permanente.

tool: mem_capture_passive

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

---

Project management

tool: mem_current_project

Detectá en qué proyecto estás trabajando. Returna 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. Useful para troubleshooting cuando algo no funciona como esperás.

---

Avanzado: Comparar y juzgar memorias

Esta es la parte más inteligente de Engram.

tool: mem_judge

Cuando guardás algo nuevo, Engram puede detectar que conflictúa con algo existente. Te devuelve candidates[] y te pide que juzgués 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 vos elegís, 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: Tu agente de IA que nunca olvida — Intro a Engram y por qué te sirve.

Un binary, una DB, cero drama.