mex-memory/mex

Team memory for engineers and their AI agents. Lives in your repo. Shared through Git.

해결하는 문제

MEX는 엔지니어링 팀과 AI 코딩 에이전트를 위한 공유 프로젝트 메모리 시스템을 제공합니다. 중요한 아키텍처 결정, 디버깅 기록, 예외 케이스가 개인의 머릿속이나 일시적인 에이전트 세션에 갇혀 있는 지식의 분산 문제를 해결하기 위해, Git 리포지토리 내에 지속 가능하고 버전 관리 가능한 컨텍스트 저장소를 만듭니다.

작동 방식

MEX는 정규 지식과 로컬 검색 기계를 분리합니다:

  • 정규 메모리: 지식은 구조화된 Markdown 파일(위키, 사양서, Relay, 수신 제안)로 리포지토리 내에 직접 저장되어 표준 Git 커밋 및 푸시를 통해 공유할 수 있습니다.
  • 로컬 인덱스: 각 사용자는 자체적인 로컬 SQLite 기반 인덱스(코드 그래프 및 위키 검색)를 유지하며, 정규 파일과 소스 코드에서 재구성할 수 있습니다.
  • 코드 그래프: Tree-sitter 문법을 사용하여 코드 내의 심볼과 관계(타입스크립트, 자바스크립트, 파이썬, 루스트 지원)를 매핑하여 AI 에이전트에게 정확한 증거를 제공합니다.
  • 근거화: 위키의 주장은 특정 코드 심볼에 연결됩니다. 코드가 변경되면 MEX는 "드리프트"를 감지하여 문서 검토가 필요함을 알립니다.
  • 에이전트 통합: Claude Code나 Codex와 같은 에이전트가 컨텍스트를 검색하고 지식 제안 또는 인수인계를 초안할 수 있도록 지침과 기술을 제공합니다. 이 제안은 정규화되기 전에 인간이 검토하고 승인해야 합니다.

대상 사용자

AI 코딩 에이전트를 사용하고, 한 사람 또는 에이전트가 습득한 컨텍스트가 팀 전체에 보존되고 접근 가능하도록 하려는 소프트웨어 엔지니어링 팀을 위한 것입니다.

주요 특징

  • Git 기반 공유: 호스팅된 서비스나 중앙 데이터베이스가 필요 없으며, 메모리는 코드와 함께 이동합니다.
  • 프로젝트 허브: 로컬 브라우저 기반 인터페이스로 지식 그래프를 탐색하고 제안을 검토하며 인수인계를 관리할 수 있습니다.
  • Relays: 엔지니어 간의 업무 인수인계를 구조화하여 진행 상황, 장애 요소, 다음 단계를 기록합니다.
  • 코드 연결 설명: 설명문과 구현 사이에 직접적인 근거를 설정하여 문서의 쇠퇴를 방지합니다.
  • 다중 에이전트 지원: 지침 앵커와 Claude Code 및 Codex 전용 기술을 통해 다양한 AI 도구와 호환됩니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트