Claude Code가 모든 것을 잊어버리는 것에 지쳐서, Glutamate를 만들었습니다.

Claude Code와의 모든 세션은 똑같은 방식으로 시작됩니다.

새 터미널을 엽니다. 첫 메시지를 입력합니다. 그러고 나서 다음 10분 동안 어제 무엇을 하고 있었는지, 특정 함수가 왜 그렇게 작동하는지, 그리고 어떤 버그를 이미 수정했는지 다시 설명하는 데 시간을 보냅니다.

에이전트(Agent)가 멍청한 것은 아닙니다. 그저 기억상실증에 걸린 것뿐입니다. 매. 세션. 마다 말이죠.

저는 프롬프팅(Prompting)을 통해 이를 해결하려 노력했습니다. CLAUDE.md 파일, 상세한 시스템 프롬프트(System prompts), 매 세션 시작 시 정교한 컨텍스트 덤프(Context dumps) 등을 시도했습니다. 도움이 되긴 했지만, 확장성(Scale)이 없었습니다. 그래서 저는 Glutamate를 만들었습니다. Claude Code의 라이프사이클(Lifecycle)에 연결되어 에이전트에게 세션을 넘나드는 지속적이고 구조화된 메모리(Memory)를 제공하는 MCP 툴킷(Toolkit)입니다.

기능

실패 메모리 (Failure Memory)

에이전트가 버그를 디버깅하고 해결책을 찾으면, Glutamate는 이를 기록합니다. 다음 세션에서 동일한 버그가 발생하면 즉시 회상합니다.

"지난번에는 3시간이 걸렸지만, 이제는 30초면 됩니다."

에이전트들은 동일한 버그를 다시 유발하고 동일한 해결책을 다시 발견하는 습관이 있습니다. 실패 메모리(Failure Memory)는 그 루프를 끊어줍니다.

코드 인텔리전스 (Code Intelligence)

Glutamate는 tree-sitter를 사용하여 8개 언어에 대해 에이전트에게 구조적인 코드 이해도를 제공하는 로컬 stdio MCP 서버를 실행합니다.

하나의 함수를 찾기 위해 파일 2,000줄을 읽는 대신, 에이전트는 정확히 필요한 심볼(Symbol) 20줄을 읽습니다.

이러한 복합적인 효과가 중요합니다. 에이전트는 세션당 수십 번 코드를 읽습니다. 각 읽기 작업이 2,000줄 대신 20줄로 줄어듭니다. 긴 세션이 끝날 때까지 컨텍스트(Context)는 오염되지 않고 품질은 저하되지 않습니다.

병렬 세션 인식 (Parallel Session Awareness)

동일한 프로젝트에서 여러 개의 Claude Code 창을 실행 중인가요? 이들은 서로를 인지하고 협력합니다. 다른 도구는 이 문제를 해결하지 못합니다. 기존의 메모리 시스템은 단일 에이전트의 메모리로 작동하지만, Glutamate는 에이전트 간의 조율을 수행합니다.

의사결정 고고학 (Decision Archaeology)

커밋 해시(Commit hash)를 전달하면, 해당 세션 동안 작성된 모든 작업 문서(Task doc)를 가져옵니다. 코드가 왜 현재의 모습인지에 대한 전체 이력을 git과 직접 연결하여 제공합니다. 3개월 후, 여러분은 "왜 이렇게 했지?"라고 묻지 않을 것입니다. 이미 알고 있을 테니까요.

커밋 후 노후화 감지 (Post-commit Stale Detection)

모든 git commit 이후에, Glutamate는 방금 변경한 파일을 참조하는 문서들을 찾아내어 이를 노후화(stale)된 것으로 표시합니다. 에이전트에게는 다음과 같은 자극을 줍니다: 컨텍스트가 아직 신선할 때 이 문서들을 다시 생성하세요. 문서가 소리 없이 부식되도록 내버려 두지 않습니다.

LiveDocs 작업 추적 (LiveDocs Task Tracking)

에이전트가 무엇을 하고 있는지 — 무엇이 열려 있고, 무엇이 완료되었으며, 다음 단계는 무엇인지 — 실시간으로 가시성을 제공합니다.

내부 작동 원리

두 개의 MCP 서버가 나란히 실행됩니다:

Remote HTTP server (Docker) - 데이터베이스를 소유합니다. livedocs, 지식 베이스 (knowledge base), 규칙 (rules), 실패 메모리 (failure memory), 분석 (analytics), 세션 (sessions), 패턴 (patterns)을 처리합니다. 각 도구 호출 시 project_root를 전달하므로, 하나의 서버가 여러 프로젝트를 처리할 수 있습니다. 새로운 프로젝트는 첫 호출 시 자동으로 등록됩니다.

Local stdio server - 상태가 없는 (stateless) tree-sitter 도구들입니다. 데이터베이스 없이 구조적인 코드 분석만 수행합니다. 호스트 머신에서 실행되며, .mcp.json에서 설정됩니다.

세 가지 Claude Code 훅 (hooks)이 모든 것을 연결합니다:

• UserPromptSubmit - 모든 프롬프트 이전에 실행되며, 지식 베이스(KB)와 작업 이력 전체에 대해 하이브리드 FTS5 + 벡터 검색 (vector search)을 수행하여 관련 컨텍스트를 자동으로 주입합니다.
• PostToolUse (git commit) - 노후화된 문서를 찾아내고, 지식이 신선할 때 에이전트에게 이를 다시 생성하도록 지시합니다.
• SessionStart - 규칙, 과거의 실패 사례, 프로젝트 경계 맵 (project boundary map)을 로드하여 에이전트가 방향을 잡고 시작할 수 있게 합니다.

의도 분류기 (intent classifier, 로컬 Ollama 모델)는 각 프롬프트를 feature (기능), debug (디버그), refactor (리팩터링), 또는 question (질문)으로 태깅하고, 그에 따라 서로 다른 컨텍스트 프로필을 로드합니다. 디버그 프롬프트는 실패 메모리를 로드하고, 기능 프롬프트는 패턴과 모듈 문서를 로드합니다.

왜 "Glutamate"인가

Glutamate는 뇌에서 신경 전달 물질 (neurotransmitter)로 작용하는 아미노산입니다. 그 역할은 뉴런 사이에서 신호를 전달하는 것입니다. 이것이 없다면 기억은 형성되지 않고, 연결은 구축되지 않습니다.

당신의 AI 개발 환경에서도 동일한 아이디어를 적용한 것입니다.

아직 구축되지 않은 기능

• pip install glutamate-mcp 온보딩 (현재는 수동 Docker 설정이 필요함)
• 멀티 테넌트 (Multi-tenant) 호스팅 버전 (현재는 단일 사용자용, 셀프 호스팅 방식)

현재 클로즈 베타 (Closed beta)를 운영 중입니다. 랜딩 페이지와 데모 영상은 다음과 같습니다: beta.glutamate.pro

아키텍처 (Architecture), 훅 시스템 (Hook system), 또는 그 외 다른 사항에 대해 궁금한 점이 있다면 기꺼이 답변해 드리겠습니다.