← 목록으로
지난 소식
에이전트 메모리에도 OpenTelemetry 같은 전환점이 필요함
요약
- 코딩 에이전트마다 서로 다른 메모리 형식을 사용함에 따라 도구 간 호환성 문제가 발생하고 있습니다.
- 이를 해결하기 위해 OpenTelemetry 사례처럼 데이터 모델과 프로토콜을 공동 표준화하여 공유 기반을 마련하고 차별화된 기능을 분리하는 방식이 필요합니다.
- 단순한 데이터 내보내기를 넘어 실시간 주소 지정과 같은 공통 명세에 대한 합의가 핵심입니다.
- 코딩 에이전트마다 메모리 형식이 달라 한 도구가 학습한 내용을 다른 도구가 읽지 못하며, 필요한 것은 새 도구보다 공통 형식에 대한 합의임
- OpenTelemetry가 데이터 모델, 의미 규약, 프로토콜을 공동 표준으로 만들고 저장과 분석은 경쟁 영역으로 남겼듯, 에이전트 메모리도 공유할 기반과 차별화할 기능을 나눌 수 있음
- 기존 이식성 제안은 주로 업체 간 내보내기를 해결하지만, 같은 저장소에서 동시에 일하는 CI 에이전트와 편집기, 리뷰 봇이 동일한 메모리를 읽고 쓰는 실시간 주소 지정도 필요함
- 공통 레코드는 메모리의 적용 범위, 정체성, 내용, 유효 기간과 작성 주체를 담고, 공통 작업 계약과 적합성 테스트로 도구 간 의미를 일치시키는 형태가 될 수 있음
- 공유 메모리는 프롬프트 인젝션 경로가 될 수 있으며 어떤 형식도 오염을 완전히 막지는 못함. 표준화 역시 새 형식을 하나 더 추가하기보다 기존 프로젝트와 제안의 합의가 필요함
서로 읽지 못하는 에이전트 메모리
- 일반적인 코딩 환경에서도 호환되지 않는 메모리 형식이 함께 쓰임
- 저장소에는 AGENTS.md, CLAUDE.md, Cursor의 .cursor/rules/*.mdc가 쓰임
- Anthropic 메모리 도구는 /memories 아래에 파일을 기록함
- Copilot의 저장소별 사실은 GitHub 측에 저장됨
- 메모리 MCP 서버는 JSONL 지식 그래프를 사용함
- 각 형식은 개별적으로 합리적이지만, 모두 “에이전트가 미래의 자신을 위해 특정 주소에 남긴, 일정 기간 유효한 메모”라는 작은 개념을 다시 구현함
- CI 에이전트가 얻은 교훈은 해당 도구 안에 머물며, 편집기 에이전트나 새로 도입한 도구가 읽을 수 없음
- r/ClaudeAI, r/LocalLLaMA, r/cursor에 계속 등장하는 자체 메모리 계층은 실제 수요를 보여주지만, 각각의 저장 방식과 스키마, MCP 도구는 호환되지 않는 형식을 더 늘림
- 오픈소스 도구 LoreKit의 형식도 한계가 있는 여러 제안 중 하나이며, 메모리 문제를 이미 해결한 정답은 아님
OpenTelemetry가 보여준 합의 방식
- 2019년 이전 관측 가능성 업체들은 자체 에이전트, 계측 라이브러리, 데이터 형식을 제공했고, 업체를 바꾸려면 코드를 다시 계측해야 했음
- 이를 해결하려던 OpenTracing과 OpenCensus도 서로 경쟁하다가 2019년 OpenTelemetry로 통합됨
- OpenTelemetry는 네 가지를 공동 기반으로 삼음
- 데이터 모델은 스팬, 메트릭, 로그 레코드를 정의함
- 의미 규약은 service.name, http.* 같은 공통 이름을 정함
- 프로토콜은 데이터 전송 방식인 OTLP를 사용함
- 참조 구현으로 공통 SDK와 Collector를 제공함
- 업체들은 저장, 질의, 분석처럼 데이터를 활용하는 방식으로 계속 경쟁하고, 사용자는 한 번만 계측할 수 있게 됨
- 에이전트 메모리 형식은 아직 변경 가능한 초기 단계이며, MCP와 AGENTS.md 는 이미 Linux Foundation의 Agentic AI Foundation이라는 중립적 표준 기반에 속해 있음
현재 메모리 형식의 차이
- 다음 비교는 빠르게 변하는 도구들의 2026년 말 시점 스냅샷을 전제로 함
- 지시 파일인 AGENTS.md, CLAUDE.md, Cursor .mdc 규칙은 Markdown 파일 전체가 단위임
- 파일 경로로 주소를 지정하고 Cursor는 globs도 사용함
- 자동으로 잊지 않으며 사람이 편집함
- Anthropic 메모리 도구는 모델이 선택한 /memories 아래 경로에 파일을 저장함
- GitHub Copilot Memory는 코드 인용이 붙은 사실을 저장소 단위로 보관함
- 28일 동안 사용하지 않으면 삭제됨
- 코드와 대조할 수 있는 근거와 기본 망각 정책을 결합하지만, 한 제품 안에 갇혀 있음
- Letta 핵심 메모리는 문자 수 limit이 있는 블록을 에이전트의 label로 식별함
- Mem0는 서비스가 메시지에서 추출한 사실을 저장함
- user_id, agent_id, run_id, app_id로 주소를 지정하고 선택적으로 만료일을 설정함
- LangGraph BaseStore 는 JSON value 딕셔너리를 namespace 튜플과 key로 식별함
- 선택적 TTL을 지원하며 기본적으로 읽을 때 TTL을 재설정함
- put(namespace, key, value)처럼 핵심 인터페이스를 작게 유지할 수 있음을 보여줌
- MCP 참조 메모리 서버는 엔티티, 관계, 관측으로 지식 그래프를 구성함
- Graphiti / Zep은 그래프 간선에 사실을 저장하고 엔티티와 간선으로 주소를 지정함
- 사실을 삭제하는 대신 무효화하며, 사실이 유효했던 시간과 기록된 시간을 별도로 관리함
- LoreKit은 범위, 키, 수명주기가 있는 레코드를 범위 문자열과 key로 식별함
- 공통 명세는 이들 도구의 장점을 보존할 필요가 있으며, AGENTS.md 는 알려진 경로의 평범한 파일도 표준이 될 수 있음을 보여줌
내보내기와 실시간 공유는 다른 문제
- MacPaw Research의 Portable Memory는 바이트 단위로 재현 가능한 직렬화, 삭제 표식, 선택적 서명을 갖춘 .mem 번들임
- Open Memory Protocol은 대화와 그로부터 파생된 메모리를 매니페스트가 포함된 ZIP으로 플랫폼 간 이동시키는 2026년 4월 초안임
- Cognee의 COGX는 Mem0, Letta, Zep에서 메모리를 가져올 수 있음
- 이 제안들은 주로 한 사람의 메모리를 업체 A에서 B로 옮기는 내보내기에 집중함
- 코딩 도구에는 실시간 주소 지정도 필요함
- CI 작업, 편집기 에이전트, 리뷰 봇이 같은 저장소에서 동시에 작동할 때 동일한 위치를 읽고 쓰며 그 의미에 합의해야 함
- 완전한 명세는 내보내기와 실시간 주소 지정을 모두 다뤄야 함
공통 레코드와 명세 계층
- 모든 메모리 형식은 네 가지 질문에 답함
- 적용 범위: 어디에서 참인 메모리인가
- 정체성: 다시 쓰면 기존 항목을 갱신하는가, 중복 항목을 만드는가
- 내용: 무엇을 기록하는가
- 유효 기간: 언제 더 이상 참이 아니게 되는가
- 별도로 기록해야 할 차이는 작성 주체임
- 지시 파일은 사람이 작성함
- Anthropic 메모리 도구, Letta, LoreKit에서는 모델이 작성함
- Mem0와 Graphiti에서는 서비스가 대화에서 사실을 추출함
- 명세가 한 방식을 선택할 필요는 없지만, 읽는 쪽이 신뢰 수준을 판단하도록 작성 주체를 남겨야 함
- 공통 레코드는 프런트매터와 본문으로 구성할 수 있으며, 아래 필드명은 확정 제안이 아닌 데이터 모델 예시임
- address와 key는 적용 위치를, id는 정체성을 나타냄
- lifecycle은 만료와 수명 연장을, written_by는 작성 주체를 나타냄
- content_type은 본문을 어떻게 해석할지 알려줌
- 도구별 추가 정보는 다른 도구가 무시할 수 있는 이름공간 아래 attributes에 저장함
- 같은 레코드를 전송용 JSON으로도 직렬화할 수 있음
- 예시 레코드는 통합 테스트 전에 로컬 Postgres를 실행해야 한다는 교훈을 저장함
- 저장소 주소, tests-need-local-postgres 키, lesson 종류, claude-code 작성자, PR 번호와 CI 실행 정보를 함께 담음
- Postgres가 없으면 ECONNREFUSED 127.0.0.1:5432가 발생하므로 pnpm test 전에 docker compose up -d db를 실행해야 하며, 테스트 설정 자체는 DB를 시작하지 않음
- 레코드 주변에는 OpenTelemetry와 유사한 세 계층을 둘 수 있음
- 규약: global, project, repo, branch와 모노레포용 주소 수준, 메모리 종류, vcs.*, ci.*, agent.* 속성 이름공간을 하나의 버전 관리 레지스트리에 정의함
- 작업 계약: 쓰기, 읽기, 목록 조회, 검색, 보관의 입력과 출력을 고정하고 MCP로 노출함. 현재는 MCP 인터페이스가 있어도 도구별 작업과 의미가 다름
- 적합성 테스트: 참조 구현 대신 레코드 왕복 변환 시 정보 보존, 재작성 시 알 수 없는 속성 보존, 명세대로의 만료 동작을 검사함
- 저장 방식, 순위 산정, 임베딩, 사용자 인터페이스는 표준 밖에 두고 도구들이 경쟁할 영역으로 남겨야 함
- 명세는 LoreKit 저장소나 특정 업체가 아닌 중립적인 곳에서 관리해야 함
표준화에 대한 반론과 보안 한계
- 도구 제작자의 이해관계가 표준에 반영될 수 있으므로 LoreKit을 표준의 틀로 삼아서는 안 됨
- 공통 명세가 다른 형태가 되더라도 LoreKit이 이를 채택해야 함
- MCP는 호출을 표준화하지 메모리 레코드 자체를 표준화하지 않음
- OpenTelemetry에 프로토콜과 데이터 모델이 모두 필요했던 것처럼 메모리에도 둘 다 필요함
- 공유 메모리는 프롬프트 인젝션 경로가 될 수 있음
- 에이전트가 읽는 것은 무엇이든 행동에 영향을 줄 수 있고, 공유는 기록 가능한 주체를 늘림
- 작성 주체 기록, Portable Memory가 이미 지원하는 선택적 서명, 의존 코드에 대한 참조로 출처와 코드 변경 여부를 확인할 수 있어야 함
- 어떤 형식도 메모리 오염을 완전히 막지는 못함
- 새 표준이 단편화만 더할 수 있다는 xkcd 927의 반론이 가장 강력함
- OpenTelemetry의 합의는 새 프로젝트 하나를 더하는 대신 기존 프로젝트를 통합하면서 이뤄짐
- 메모리도 기존 제안과 도구의 장점을 모아 공유할 부분에 합의해야 함
아직 합의하지 못한 질문
- 주소 수준을 고정 목록으로 둘지 규약으로 둘지 정해야 함
- 모노레포에는 repo와 branch 사이의 수준이 필요함
- 망각을 기본값으로 할지도 미정임
- Copilot은 기본적으로 잊고, LoreKit은 그렇지 않으며, LangGraph는 읽을 때 수명을 연장함
- 레코드가 의존 코드를 가리키면 오래된 메모리를 방어하는 데 가장 효과적이지만, 특정 코드 호스팅 서비스와 결합됨
- 조정 주체를 작업 그룹, 재단, 공개 수정 제안을 받는 명세 초안 중 무엇으로 둘지도 열려 있음
- LoreKit의 스키마와 디스크 형식은 MIT 라이선스로 공개돼 공통 논의의 구체적인 재료가 될 수 있음
- 오프라인 저장소는 열어 보고 grep과 diff로 살펴볼 수 있는 일반 Markdown 파일을 기록함
- 다른 도구의 기록과 비교해 현재 어떤 형식에도 없는 공통 요구사항을 찾아볼 수 있음
키워드
에이전트 메모리표준화OpenTelemetry