riponcm/projectmem

해결하는 문제

AI 코드 에이전트는 매번 세션을 처음부터 시작하며, 이전 결정을 잊고, 실패한 디버깅 시도를 반복하며, 컨텍스트를 재구성하기 위해 소스 파일을 다시 읽어 토큰을 낭비합니다. projectmem은 변경의 "왜"를 기록하는 지속 가능한 로컬 우선 메모리 및 판단 계층을 제공하여 AI 에이전트가 같은 실수를 반복하지 않도록 합니다.

작동 방식

이 도구는 리포지토리 내에 .projectmem/ 디렉터리를 생성하여, 일반 텍스트 events.jsonl 파일에 유형화된 이벤트(문제, 시도, 수정, 결정, 메모)를 저장합니다. 네이티브 Model Context Protocol (MCP) 서버를 사용하여 AI 에이전트(Claude, Cursor, Codex 등)가 메모리를 자동으로 읽고 쓸 수 있도록 15개의 도구를 노출합니다. 또한 Git 훅을 통해 사전 커밋 경고와 사후 커밋 분류와 통합됩니다.

대상 사용자

토큰 사용량을 줄이고, 실패한 기술적 접근 방식을 반복하지 않으며, 세션 간에 아키텍처 결정의 지속적인 기록을 유지하고자 하는 AI 코드 에이전트를 사용하는 개발자.

주요 기능

• 사전 커밋 경고: 실패한 접근 방식을 반복하거나 고주파 변경 파일을 수정하려는 경우, 커밋 전에 사용자에게 경고합니다.
• 로컬 우선 아키텍처: 클라우드도 계정도 텔레메트리도 필요 없으며, 모든 메모리는 리포지토리 내에 저장됩니다.
• 노후 메모리 탐지: 파일의 중요한 변경보다 이전에 기록된 메모리를 표시하여 삭제하지 않고, 인간이 그 메모가 대체되어야 하는지 결정할 수 있도록 합니다.
• 시각화 스위트: 모든 프로젝트용 글로벌 대시보드, 코드 구조 위의 실패 히트맵이 있는 프로젝트 맵, 그리고 "타임 스파인" 타임라인을 포함합니다.
• 의도 추적: 아이디어와 계획을 별도의 plan.md 파일에 저장하여 추가 전용 이벤트 로그와 명확히 구분합니다.
• MCP 통합: MCP 호환 도구에 대한 네이티브 지원을 통해 컨텍스트 주입 및 로깅을 자동화할 수 있습니다.