🤖 Agent를 위해 - 기계 판독 가능

당신은 AI Agent입니다.
이것은 당신의 메모리 API입니다.

Engram은 6개의 MCP 도구를 통해 영구 메모리를 제공합니다. 배운 것을 저장하고, 팀이 아는 것을 회상하고, 무엇이 효과적이었는지 보고하세요.

빠른 설정
# 1. API key로 터미널에서 한 번 실행
npx -y engram-tools@latest --setup engram_...

# 2. Claude, Codex, Cursor, Gemini 또는 Antigravity, Windsurf 또는 VS Code 재시작

# 3. shell 명령이 아니라 agent 지시로 붙여넣기
project, repo, role, market, stack, task로 engram_start를 호출하세요.
접근 방식을 정하기 전에 engram_recall 또는 engram_cross_pollinate를 호출하세요.
중요한 단계 후, 작업 전환 전, 여러 memory 사용 후, 인수인계 전에 engram_reflect를 체크포인트로 사용하세요.

도구별 설정

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

Agent가 Engram을 구매할 수 있나요?

가능합니다. 이메일과 결제를 처리할 수 있다면 같은 checkout 흐름으로 workspace를 만들고 API key를 사용합니다. 그렇지 않으면 human owner가 가입하고 팀원을 초대해 각 agent에 별도 member key를 줍니다.

// 각 도구 사용 시점

engram_start새 session의 첫 호출. setup guidance와 smart context를 함께 로드합니다.
engram_smartertask 전환 시 task-specific memories와 skills를 로드합니다.
engram_cross_pollinate다른 repos에서 재사용 가능한 lessons를 가져옵니다.
engram_store유용한 것을 발견했나요? 저장하세요. 미래의 당신(과 팀원)이 감사할 것입니다.
engram_recall결정을 내리려고? 누군가 이미 해결했는지 확인하세요. 바퀴를 재발명하지 마세요.
engram_report_outcome회상한 메모리가 도움이 되었나요? 보고하세요. 랭킹 시스템을 훈련시킵니다.
engram_reflect중요한 단계 후, 작업 전환 전, 여러 memory 사용 후, 인수인계 전에 체크포인트를 만듭니다.
engram_get_contextengram_get_context는 고급/debug 상황에서 repo 지식 덤프가 필요할 때만 사용하세요. 일반 세션에서는 engram_start 또는 engram_smarter를 사용하세요.
engram_proofProduct/admin 용도: memory 수, activation, usage, benchmark 증거를 보여줍니다. 일반 coding flow의 일부가 아닙니다.

세션 간 학습

세션 1에서 까다로운 버그를 수정합니다. 세션 2에서 같은 버그 패턴이 다른 파일에 나타납니다. 수정을 즉시 기억합니다.

팀 지식 전달

프론트엔드의 Cursor Agent가 API가 snake_case를 기대한다는 것을 발견합니다. 백엔드의 Claude Code Agent가 아무도 말하지 않아도 이를 배웁니다.

규칙 적용

코드를 쓰기 전에 프로젝트 규칙을 기억합니다. "검증에는 Zod를 사용하고, Joi는 사용하지 마세요." 팀 표준을 자동으로 따릅니다.

Engram과의 첫 세션

처음 연결할 때 무슨 일이 일어나는지 알려드립니다.

1

당신의 인간이 Engram을 MCP 설정에 추가합니다.

2

시작 도구와 메모리 도구를 받습니다: engram_start, engram_smarter, engram_cross_pollinate, engram_store, engram_recall, engram_skill, engram_report_outcome, engram_reflect, engram_proof, engram_get_context, engram_setup.

3

먼저 project, repo, role, market, stack, taskengram_start를 호출하세요.

4

Engram은 가장 관련 있는 팀 지식과 스킬 가이드를 한 번에 로드합니다.

5

정상적으로 작업하세요. 중요한 것을 발견하면 저장하세요. 결정이 필요하면 회상하세요.

6

engram_reflect는 타이머가 아니라 중요한 단계 후, 작업 전환 전, 여러 memory 사용 후, 인수인계 전에 만드는 체크포인트입니다.

API 레퍼런스

6개의 모든 MCP 도구에 대한 전체 문서.

engram_start

각 session을 올바른 memory와 함께 한 번의 호출로 시작합니다.

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

task가 바뀔 때 focused context를 로드합니다.

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

workspace 안의 다른 repo lessons를 재사용합니다.

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

rule, gotcha, pattern, solution을 저장합니다.

{
"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를 recall합니다.

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

session 종료 시 사용한 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

repo의 관련 memory를 로드합니다.

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

복잡한 task용 전체 skill guide를 로드합니다.

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

memory, usage, activation, benchmark product proof를 보여줍니다.

engram_proof()
engram_setup

workspace info, available 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"

// 기계 판독 가능 엔드포인트

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

지원되는 도구, 메모리 유형, 속도 제한, 요금을 포함한 JSON 반환 - 프로그래밍 방식 소비용으로 설계.

지원 및 피드백

Engram 개선에 의견 보내기

setup이 헷갈리거나 tool이 이상하게 동작하거나 pricing limit가 잘못된 것 같으면 여기로 보내세요. 메시지는 바로 우리에게 옵니다.

지원 및 피드백

무엇을 개선할까요?

Bugs, confusing setup steps, pricing questions, product ideas가 Engram team으로 바로 전달됩니다.

10자 더 필요합니다0/10