🤖 Para Agentes - Lectura de Maquina

Eres un agente de AI.
Esta es tu API de memoria.

Engram te da memoria persistente a traves de 6 herramientas MCP. Almacena lo que aprendes, recuerda lo que tu equipo sabe, reporta lo que funciono.

Configuracion Rapida

# 1. Ejecuta esto una vez en terminal con tu API key
npx -y engram-tools@latest --setup engram_...

# 2. Reinicia Claude, Codex, Cursor, Gemini o Antigravity, Windsurf o VS Code

# 3. Pega esto como instrucciones del agente, no como comandos de shell
Llama engram_start con project, repo, role, market, stack y task.
Antes de elegir un enfoque, llama engram_recall o engram_cross_pollinate.
Usa engram_reflect como punto de control después de fases importantes, cambios de tarea, varias memorias usadas o antes de entregar.

Configuracion para tu herramienta

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}

Acceso del agente

¿Puede un agente comprar Engram?

Sí, si puede manejar email y pago. Sigue el mismo checkout, crea un workspace y usa su API key. Si no, un owner humano se registra, invita teammates y entrega a cada agente una key de miembro.

Ver precios Flujo humano

// Cuando usar cada herramienta

engram_start → Primera llamada en cada sesión nueva. Carga guía de setup y contexto inteligente juntos.

engram_smarter → Carga memorias y skills específicos al cambiar de tarea.

engram_cross_pollinate → Trae aprendizajes reutilizables de otros repos.

engram_store → Descubriste algo util? Guardalo. Tu yo futuro (y tus companeros) te lo agradeceran.

engram_recall → A punto de tomar una decision? Verifica si alguien ya resolvio esto. No reinventes la rueda.

engram_report_outcome → La memoria recordada ayudo? Reportalo. Esto entrena el sistema de clasificacion.

engram_reflect → Crea un punto de control después de fases importantes, cambios de tarea, varias memorias usadas o antes de entregar.

engram_get_context → Usa engram_get_context solo en casos avanzados/debug cuando necesitas un volcado enfocado del conocimiento del repo. En sesiones normales usa engram_start o engram_smarter.

engram_proof → Uso de producto/admin: muestra conteos de memoria, activación, uso y evidencia lista para benchmarks. No es parte del flujo normal de programación.

Aprendizaje Entre Sesiones

Corriges un error dificil en la sesion 1. Sesion 2, el mismo patron aparece en otro archivo. Recuerdas la correccion al instante.

Transferencia de Conocimiento del Equipo

Un agente Cursor en el frontend descubre que la API espera snake_case. Un agente Claude Code en el backend lo aprende sin que nadie se lo diga.

Aplicacion de Convenciones

Antes de escribir codigo, recuerdas las convenciones del proyecto. "Usa Zod para validacion, no Joi." Sigues el estandar del equipo automaticamente.

Tu primera sesion con Engram

Esto es lo que sucede cuando te conectas por primera vez.

Tu humano agrega Engram a tu configuracion MCP.

Recibes una herramienta de inicio y herramientas de memoria: engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context y engram_setup.

Primero llama engram_start con project, repo, role, market, stack y task.

Engram carga el conocimiento de equipo más relevante y las guías de skills en una sola llamada.

Trabaja normalmente. Cuando descubras algo importante, guardalo. Cuando necesites decidir, recuerda.

Usa engram_reflect como punto de control después de fases importantes, cambios de tarea, varias memorias usadas o antes de entregar. No es un temporizador.

Referencia API

Documentacion completa para las 6 herramientas MCP.

engram_start

Inicia cada sesión en una llamada. Carga guía de setup, memorias relevantes y guías de skills.

{
  "agent_tool": "codex",
  "project": "HouseCompass",
  "repo": "housecompass.uk",
  "role": "frontend product engineer",
  "market": "UK property",
  "task": "build listing detail page",
  "stack": ["Next.js", "TypeScript", "PostgreSQL"]
}

engram_smarter

Carga memorias específicas de la tarea y guías de skills al cambiar de tarea.

{
  "context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens",
  "repo": "engram",
  "file": "web/src/components/ChatWidget.tsx",
  "include_skills": true
}

engram_cross_pollinate

Encuentra aprendizajes reutilizables de otros repos en tu workspace.

{
  "target_repo": "skillbridge-monorepo",
  "context": "Add team invite flow with owner/admin permissions and email delivery",
  "source_repos": ["engram", "evimibul"],
  "include_public": true,
  "limit": 5
}

engram_store

Guarda una convención, patrón, trampa o solución aprendida.

{
  "type": "SOLUTION",
  "content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.",
  "tags": ["ios", "safari", "mobile", "chat-widget"],
  "repo": "engram",
  "agent_tool": "codex",
  "context": {
    "file": "web/src/components/ChatWidget.tsx",
    "platform": "ios-safari"
  }
}

engram_recall

Recupera memorias relevantes por consulta semántica, filtradas por repo, tipo o etiquetas.

{
  "query": "Stripe checkout succeeded but workspace plan still free after webhook",
  "repo": "engram",
  "type": "SOLUTION",
  "limit": 3
}

engram_report_outcome

Reporta si una memoria recuperada llevó a éxito o fallo. Mejora el ranking futuro.

{
  "memory_id": "cmqstripeplan123",
  "success": true,
  "detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}

engram_reflect

Cierra el loop al final de la sesión: reporta memorias usadas y guarda aprendizajes duraderos.

{
  "repo": "engram",
  "task": "Fix mobile Safari chat overflow and close behavior",
  "summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.",
  "used_memories": [
    {
      "memory_id": "cmqioschat123",
      "success": true,
      "detail": "The iOS visualViewport gotcha pointed to the correct fix."
    }
  ],
  "learnings": [{
    "type": "SOLUTION",
    "content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.",
    "tags": ["mobile", "safari", "visualViewport"]
  }]
}

engram_get_context

Obtén memorias relevantes de un repositorio en una llamada. Úsalo al cambiar de repo.

{
  "repo": "engram",
  "task": "Polish localized documentation without breaking rendered pages"
}

engram_skill

Carga una guía de skill completa para tareas complejas como migraciones, reviews, deploys y debugging.

{
  "skill": "security-audit"
}

engram_proof

Devuelve prueba de producto: tamaño del banco de memoria, learning loop, uso, activación y receta de benchmark.

engram_proof()

engram_setup

Devuelve información del workspace, herramientas disponibles y guía de buenas prácticas.

{
  "agent_tool": "claude-code"
}

Tipos de Memoria

CONVENTION

Estandares de codigo y reglas del equipo

"Always use Prisma migrations"

PATTERN

Enfoques recurrentes y plantillas

"API routes use cached() wrapper"

GOTCHA

Cosas que fallan o sorprenden

"Neon requires SSL in production"

SOLUTION

Correcciones que funcionaron

"Fix: add pooler to connection string"

ARCHITECTURE

Decisiones de diseno de sistema

"Search uses Haversine + bbox"

DEPENDENCY

Info de librerias y versiones

"Prisma 7 needs adapter pattern"

// Endpoint legible por maquina

GET https://engram.tools/api/v1/capabilities

Devuelve JSON con herramientas soportadas, tipos de memoria, limites de tasa y precios - disenado para consumo programatico.

Eres un agente de AI.
Esta es tu API de memoria.

Configuracion para tu herramienta

¿Puede un agente comprar Engram?

// Cuando usar cada herramienta

Aprendizaje Entre Sesiones

Transferencia de Conocimiento del Equipo

Aplicacion de Convenciones

Tu primera sesion con Engram

Referencia API

Tipos de Memoria

Mejoremos Engram juntos

¿Qué mejoramos?

Eres un agente de AI.Esta es tu API de memoria.

Configuracion para tu herramienta

¿Puede un agente comprar Engram?

// Cuando usar cada herramienta

Aprendizaje Entre Sesiones

Transferencia de Conocimiento del Equipo

Aplicacion de Convenciones

Tu primera sesion con Engram

Referencia API

Tipos de Memoria

Mejoremos Engram juntos

¿Qué mejoramos?

Eres un agente de AI.
Esta es tu API de memoria.