🤖 Для агентов - машиночитаемый

Ты AI-агент.
Это твой API памяти.

Engram дает тебе постоянную память через 11 MCP-инструментов. Сохраняй то, что узнаешь, загружай smart context, переноси lessons между репозиториями, доказывай usage и закрывай loop через reflection.

Быстрая настройка

# 1. Один раз выполните в терминале с API key
npx -y engram-tools@latest --setup engram_...

# 2. Перезапустите Claude, Codex, Cursor, Gemini или Antigravity, Windsurf или VS Code

# 3. Вставьте это как инструкции агенту, не как shell-команды
Вызовите engram_start с project, repo, role, market, stack и task.
Перед выбором подхода вызовите engram_recall или engram_cross_pollinate.
Если контекст был сжат, восстановлен или неполон, сначала вызовите engram_rehydrate. Используйте engram_reflect как checkpoint после важных этапов или перед передачей работы.

Настройка для вашего инструмента

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

Доступ агента

Может ли агент купить Engram?

Да, если агент может пройти email и оплату. Он использует тот же checkout, создает workspace и работает со своим API key. Иначе human owner регистрируется, приглашает участников и выдает каждому агенту отдельный member key.

Открыть цены Настройка для человека

// Когда использовать каждый инструмент

engram_start → Первый вызов в каждой новой сессии. Загружает setup guidance и smart context вместе.

engram_rehydrate → Вызывайте после compaction, summary, resume или потери истории. Возвращает последний checkpoint, решения, открытые задачи, gotchas и свежие learnings.

engram_smarter → Загружает task-specific memories и skills при смене задачи.

engram_cross_pollinate → Берет переиспользуемые lessons из других repos.

engram_store → Обнаружил что-то полезное? Сохрани. Будущий ты (и коллеги) скажут спасибо.

engram_recall → Собираешься принять решение? Проверь, решал ли кто-то это раньше. Не изобретай велосипед.

engram_report_outcome → Вспомненная память помогла? Сообщи. Это тренирует систему ранжирования.

engram_reflect → Создает контрольную точку после важных этапов, смены задачи, нескольких использованных memories или перед передачей работы.

engram_get_context → Используйте engram_get_context только для продвинутых/debug случаев, когда нужен сфокусированный срез знаний репозитория. В обычных сессиях используйте engram_start или engram_smarter.

engram_proof → Продуктовый/admin сценарий: показывает объем memories, активацию, usage и benchmark-ready proof. Не часть обычного coding flow.

Протокол feedback для агента

Не заполняй human form. Обучай memory loop.

Если memory помогла, устарела или пришла из неверного контекста, сообщи через tools. Этот сигнал улучшает будущий ranking.

01После использования recalled memory вызови engram_report_outcome с success true или false.

02Если несколько memories повлияли на работу, используй engram_reflect как checkpoint.

03Если другой repo мог решить pattern, вызови engram_cross_pollinate до планирования.

Обучение между сессиями

Ты исправляешь сложный баг в сессии 1. Сессия 2, тот же паттерн в другом файле. Ты мгновенно вспоминаешь исправление.

Передача знаний команды

Агент Cursor на фронтенде обнаруживает, что API ожидает snake_case. Агент Claude Code на бэкенде узнает это без чьей-либо подсказки.

Соблюдение конвенций

Перед написанием кода ты вспоминаешь конвенции проекта. "Используй Zod для валидации, не Joi." Ты автоматически следуешь стандарту команды.

Ваша первая сессия с Engram

Вот что происходит при первом подключении.

Ваш человек добавляет Engram в вашу MCP-конфигурацию.

Вы получаете стартовый инструмент и memory tools: engram_start, engram_rehydrate, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context и engram_setup.

Сначала вызовите engram_start с project, repo, role, market, stack и task.

Engram загружает самые релевантные знания команды и skill guides одним вызовом.

Работайте как обычно. Когда обнаружите что-то важное, сохраните. Когда нужно решить, вспомните.

Используйте engram_reflect как контрольную точку после важных этапов, смены задачи, нескольких использованных memories или перед передачей работы. Это не таймер.

Справка API

Полная документация для всех 11 MCP-инструментов.

engram_start

Запускает каждую сессию одним вызовом с нужной memory.

{
  "agent_tool": "codex",
  "project": "English.cash",
  "repo": "english.cash",
  "role": "full-stack product engineer",
  "market": "English learning",
  "task": "fix guest practice so it uses the same API path as paid practice",
  "stack": ["Next.js", "TypeScript", "PostgreSQL", "LLM router"]
}

engram_rehydrate

Возвращает рабочую карту после compaction, summary, resume или потери контекста.

{
  "agent_tool": "codex",
  "project": "Engram",
  "repo": "engram",
  "task": "continue mobile Safari chat fix after context compaction",
  "reason": "chat was compacted and only a short summary remains",
  "depth": "standard",
  "limit": 12
}

engram_smarter

Загружает точный контекст при смене задачи.

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

Переиспользует уроки из других repo 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

Сохраняет правило, gotcha, pattern или решение.

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

Находит полезные memories перед решением.

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

engram_report_outcome

Сообщает, помогла ли memory, и улучшает ranking.

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

engram_reflect

Закрывает сессию отчетом о memories и learnings.

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

Загружает релевантную memory для repo.

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

engram_skill

Загружает полный skill guide для сложной задачи.

{
  "skill": "security-audit"
}

engram_proof

Показывает product proof: memory, usage, activation и benchmark.

engram_proof()

engram_setup

Показывает workspace info, доступные tools и best practices.

{
  "agent_tool": "claude-code"
}

Типы памяти

CONVENTION

Стандарты кодирования и правила команды

"Always use Prisma migrations"

PATTERN

Повторяющиеся подходы и шаблоны

"API routes use cached() wrapper"

GOTCHA

То, что ломается или удивляет

"Neon requires SSL in production"

SOLUTION

Исправления, которые сработали

"Fix: add pooler to connection string"

ARCHITECTURE

Решения по дизайну системы

"Search uses Haversine + bbox"

DEPENDENCY

Информация о библиотеках и версиях

"Prisma 7 needs adapter pattern"

// Машиночитаемый endpoint

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

Возвращает JSON с поддерживаемыми инструментами, типами памяти, лимитами и ценами - для программного потребления.

Ты AI-агент.
Это твой API памяти.

Настройка для вашего инструмента

Может ли агент купить Engram?

// Когда использовать каждый инструмент

Не заполняй human form. Обучай memory loop.

Обучение между сессиями

Передача знаний команды

Соблюдение конвенций

Ваша первая сессия с Engram

Справка API

Типы памяти

Помогите нам улучшить Engram

Что улучшить?

Ты AI-агент.Это твой API памяти.

Настройка для вашего инструмента

Может ли агент купить Engram?

// Когда использовать каждый инструмент

Не заполняй human form. Обучай memory loop.

Обучение между сессиями

Передача знаний команды

Соблюдение конвенций

Ваша первая сессия с Engram

Справка API

Типы памяти

Помогите нам улучшить Engram

Что улучшить?

Ты AI-агент.
Это твой API памяти.