🤖 Para Agentes - Leitura de Maquina

Voce e um agente de AI.
Esta e sua API de memoria.

Engram te da memoria persistente via 6 ferramentas MCP. Armazene o que aprender, lembre o que sua equipe sabe, reporte o que funcionou.

Configuracao Rapida
# 1. Execute isto uma vez no terminal com sua API key
npx -y engram-tools@latest --setup engram_...

# 2. Reinicie Claude, Codex, Cursor, Gemini ou Antigravity, Windsurf ou VS Code

# 3. Cole isto como instruções do agente, não como comandos shell
Chame engram_start com project, repo, role, market, stack e task.
Antes de escolher uma abordagem, chame engram_recall ou engram_cross_pollinate.
Use engram_reflect como ponto de controle após fases importantes, trocas de tarefa, várias memórias usadas ou antes de passar o trabalho.

Configuracao para sua ferramenta

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

Um agente pode comprar Engram?

Sim, se conseguir operar email e pagamento. Ele segue o mesmo checkout, cria um workspace e usa sua API key. Caso contrário, um owner humano se cadastra, convida colegas e dá a cada agente uma chave de membro.

Ver preçosFluxo humano

// Quando usar cada ferramenta

engram_start → Primeira chamada em cada nova sessão. Carrega setup guidance e contexto inteligente juntos.
engram_smarter → Carrega memórias e skills específicos ao trocar de tarefa.
engram_cross_pollinate → Puxa aprendizados reutilizáveis de outros repos.
engram_store → Descobriu algo util? Armazene. Seu eu futuro (e colegas) vao agradecer.
engram_recall → Prestes a tomar uma decisao? Verifique se alguem ja resolveu isso. Nao reinvente a roda.
engram_report_outcome → A memoria lembrada ajudou? Reporte. Isso treina o sistema de classificacao.
engram_reflect → Cria um ponto de controle após fases importantes, trocas de tarefa, várias memórias usadas ou antes de passar o trabalho.
engram_get_context → Use engram_get_context apenas em casos avançados/debug quando precisar de um despejo focado do conhecimento do repositório. Em sessões normais use engram_start ou engram_smarter.
engram_proof → Uso de produto/admin: mostra contagens de memória, ativação, uso e prova pronta para benchmark. Não faz parte do fluxo normal de código.

Aprendizado Entre Sessoes

Voce corrige um bug dificil na sessao 1. Sessao 2, o mesmo padrao aparece em outro arquivo. Voce lembra da correcao instantaneamente.

Transferencia de Conhecimento da Equipe

Um agente Cursor no frontend descobre que a API espera snake_case. Um agente Claude Code no backend aprende isso sem ninguem contar.

Aplicacao de Convencoes

Antes de escrever codigo, voce lembra as convencoes do projeto. "Use Zod para validacao, nao Joi." Voce segue o padrao da equipe automaticamente.

Sua primeira sessao com Engram

Isso e o que acontece quando voce se conecta pela primeira vez.

1

Seu humano adiciona Engram a sua configuracao MCP.

2

Você recebe uma ferramenta inicial e ferramentas de memória: engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context e engram_setup.

3

Primeiro chame engram_start com project, repo, role, market, stack e task.

4

Engram carrega o conhecimento de equipe mais relevante e guias de skills em uma chamada.

5

Trabalhe normalmente. Quando descobrir algo importante, armazene. Quando precisar decidir, lembre.

6

Use engram_reflect como ponto de controle após fases importantes, trocas de tarefa, várias memórias usadas ou antes de passar o trabalho. Não é um temporizador.

Referencia API

Documentacao completa para todas as 6 ferramentas MCP.

engram_start

Inicia cada sessão em uma chamada com a memória certa.

{
  "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

Carrega contexto preciso quando a tarefa muda.

{
  "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

Reusa aprendizados de outros repos do 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 regra, gotcha, padrão ou solução.

{
  "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 memórias úteis antes de uma decisão.

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

Informa se uma memória ajudou e melhora o ranking.

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

Fecha a sessão reportando memórias usadas e aprendizados.

{
  "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

Carrega a memória relevante de um repo.

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

Carrega um guia de skill completo para tarefa complexa.

{
  "skill": "security-audit"
}
engram_proof

Mostra prova do produto: memória, uso, ativação e benchmark.

engram_proof()
engram_setup

Mostra dados do workspace, ferramentas disponíveis e boas práticas.

{
  "agent_tool": "claude-code"
}

Tipos de Memoria

CONVENTION

Padroes de codigo e regras da equipe

"Always use Prisma migrations"

PATTERN

Abordagens recorrentes e templates

"API routes use cached() wrapper"

GOTCHA

Coisas que quebram ou surpreendem

"Neon requires SSL in production"

SOLUTION

Correcoes que funcionaram

"Fix: add pooler to connection string"

ARCHITECTURE

Decisoes de design de sistema

"Search uses Haversine + bbox"

DEPENDENCY

Info de bibliotecas e versoes

"Prisma 7 needs adapter pattern"

// Endpoint legivel por maquina

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

Retorna JSON com ferramentas suportadas, tipos de memoria, limites de taxa e precos - projetado para consumo programatico.

Suporte e feedback

Ajude-nos a melhorar o Engram

Se o setup está confuso, uma ferramenta age estranho ou um limite de preço parece errado, escreva aqui. A mensagem chega direto até nós.

Suporte e feedback

O que devemos melhorar?

Bugs, passos de setup confusos, dúvidas de preço e ideias de produto chegam direto ao time Engram.

Faltam 10 caracteres0/10