당신의 에이전트는 모든 것을 잊습니다.
여기서 그들은 멈춥니다.
AI 코딩 에이전트가 작업하는 동안 스스로 작성하는 지속적이고 공유된 지식 기반. 결정, 아키텍처, 함정 및 규칙은 세션, 재시작 및 기계를 생존합니다.
세션을 종료하면 컨텍스트 창이 사라집니다. 프로젝트 메모리는 남아 있는 부분입니다: AI 에이전트를 위한 장기 메모리로, 프로젝트별로 저장되며, 해당 리포를 여는 모든 에이전트와 팀원이 읽습니다. 옆에 메모 작성 앱이 필요 없고, 복사-붙여넣기 없이 매일 아침 코드베이스를 다시 설명할 필요가 없습니다.
모든 AI 코딩 에이전트는 동일한 구멍을 가지고 있습니다. 그것은 당신의 코드베이스를 읽고, 인증 모듈이 그렇게 구축된 이유를 파악하고, 작년에 당신에게 주말을 소모하게 만든 마이그레이션 함정에 빠지며, 세션이 끝나면 모든 것이 사라집니다. 내일은 0에서 시작하고 같은 것들을 다시 발견하며 같은 토큰을 소모합니다.
그 중 일부를 CLAUDE.md에 붙여넣고 최신 상태를 유지하기를 바랍니다. 그것은 당신이 이미 알고 있는 규칙에 대해서는 작동합니다. 그러나 에이전트가 작업하는 동안 생성하는 지식, 즉 당신과 함께 방금 내린 결정, 탐색한 막다른 길, 2am에만 명확해지는 빌드에 대한 정보는 작동하지 않습니다.
프로젝트 메모리는 그 루프를 닫습니다. 당신의 에이전트는 MCP 도구를 사용하여 작업하는 동안 배운 것을 지속적인 지식 기반에 기록합니다. 그것은 당신의 계정이 아니라 프로젝트와 함께 존재하므로 다음 에이전트가 읽고, 당신의 팀원의 에이전트도 그들의 기계에서 읽습니다.
세션 기억상실, 그리고 그것이 실제로 비용이 드는 이유
증상은 너무 익숙하여 대부분의 사람들이 이를 인식하지 못합니다.
같은 아키텍처를 다시 설명합니다
모든 새로운 세션은 프로젝트가 어떻게 연결되어 있는지에 대한 같은 세 개의 단락을 입력하는 것으로 시작됩니다. 그것은 에이전틱 코딩에서 가장 많이 반복되는 프롬프트입니다.
에이전트는 이미 알고 있던 것을 다시 배우기 위해 비용을 지불합니다
행동하기 전에 리포의 절반을 다시 읽어야 하는 에이전트는 이미 어제 가지고 있던 지식을 다시 발견하는 데 실제 토큰과 실제 시간을 소모합니다.
같은 함정이 두 번 발생합니다
에이전트가 6월에 부딪혀서 수정한 함정은 7월에는 보이지 않습니다. 아무것도 기록되지 않았으므로 다음 에이전트가 다시 그 함정에 빠지는 것을 막는 것이 없습니다.
지식이 한 기계에만 남아 있습니다
당신의 에이전트가 배운 것은 당신의 세션, 당신의 노트북에 존재합니다. 당신의 팀원의 에이전트는 그 중 아무것도 알지 못하고 프로젝트를 처음부터 시작합니다.
프로젝트 메모리가 제공하는 것
AI 에이전트를 위한 장기 메모리 레이어, 이미 그 에이전트가 실행되는 IDE에 내장되어 있습니다.
세션을 초월하는 지식
메모는 프로젝트별로 서버 측에 저장됩니다. 에이전트를 종료하고, 앱을 종료하고, Mac을 재부팅하고, 노트북을 전환해도 돌아왔을 때 메모리는 여전히 존재합니다.
당신이 아닌 에이전트가 작성합니다
에이전트는 memory_save MCP 도구를 통해 정상적인 작업의 일환으로 저장하며, 확인 프롬프트가 없습니다. 당신은 아무도 업데이트하지 않는 문서 대신 스스로 채워지는 지식 기반을 얻습니다.
프로젝트의 모든 사람과 공유됨
메모리는 사용자 계정이 아니라 프로젝트에 연결되어 있습니다. 리포를 복제하고 AgentsRoom에서 열면 팀원의 에이전트가 작성한 동일한 메모리를 읽습니다.
자체적으로 생성되는 다섯 개의 폴더
아키텍처, 결정, 규칙, 함정, 기능. 폴더는 처음 사용될 때 생성되므로 지식이 나타날 때 구조가 나타납니다. 설정할 것이 없습니다.
기본적으로 생성보다 업데이트
기존 이름 아래에 메모를 저장하면 해당 메모가 제자리에서 업데이트됩니다. 메모는 시간이 지남에 따라 더 깊어지며, 40개의 유사한 항목으로 확산되지 않습니다.
실제 지식 그래프
메모는 [[wiki-links]]로 서로 연결됩니다. 그래프 보기는 이러한 링크를 그리며, 폴더별로 메모를 클러스터링하고, 오래된 메모는 흐려져서 프로젝트가 실제로 알고 있는 것을 볼 수 있습니다.
모든 것을 아우르는 퍼지 검색
검색은 메모 이름, 검색 단서, 전체 본문 및 태그를 동시에 실행하므로 두 단어로 반쯤 기억하는 결정을 찾을 수 있습니다.
무료, 메모 제한 없음
프로젝트 메모리는 유료 추가 기능이 아니며 할당량이 없습니다. 별도의 동기화 구독을 구매할 필요가 없으며, 메모리와 그 그래프는 단순히 AgentsRoom의 일부입니다.
프로젝트가 채우는 다섯 개의 폴더
정형 구조, 첫 번째 작성 시 자동 생성. 노트당 하나의 주제, 아이디어당 하나의 노트.
아키텍처모듈이 실제로 작동하는 방식과 코드가 위치하는 곳. 에이전트가 열두 개의 파일을 다시 크롤링하는 대신 읽는 노트입니다.
결정결정당 하나의 노트: 컨텍스트, 선택 및 이유. 이것은 누군가가 6개월 후에 조용히 되돌리지 못하도록 하는 부분입니다.
규칙작업 중 발견된 규칙, 처음에 적어놓은 것이 아닙니다. 명명, 패턴, 이 코드베이스가 일을 처리하는 방식.
함정함정, 과거 사건, 다시는 하지 말아야 할 것. 한 번 수정된 버그는 두 번 비용을 지불해서는 안 됩니다.
기능각 기능의 기능적 상태: 오늘 배포되는 것, 반쯤 구축된 것, 의도적으로 제외된 것.
지식이 캡처되는 세 가지 순간
모든 지식 기반의 어려운 부분은 그 안에 무엇이든 기록하는 것입니다. 프로젝트 메모리는 세 가지 측면에서 이를 해결합니다.
발생하는 대로, 기본값으로
AgentsRoom의 모든 에이전트는 시스템 프롬프트에서 메모리 지침을 받습니다: 중요한 결과가 발생한 후, 결정이 내려진 후, 함정에 빠진 후, 모듈이 이해된 후, 기능이 배포된 후, 기록합니다. 기술이나 프롬프트를 저장하는 것과 달리, 메모리 쓰기는 확인이 필요 없습니다. 이는 정상적인 작업 제스처이므로 실제로 발생합니다.
항상 기억하기, 에이전트별로
모든 에이전트에서 항상 기억하기 토글을 켜면 더 엄격한 규칙이 적용됩니다: 내구성 있는 학습이 생성된 모든 턴의 끝에서 이를 지속합니다. 리팩토링을 진행하는 아키텍트나 실패 모드를 매핑하는 QA 에이전트와 같이 많은 지식을 생성하는 역할에 유용합니다.
나가는 길에
여전히 활성 세션이 있는 에이전트를 종료할 때, AgentsRoom은 먼저 기억할 것인지 묻습니다. 기억하기를 선택하면 지침이 실행 중인 세션으로 들어가 에이전트가 탭을 닫기 전에 배운 것을 기록합니다. 지식이 일반적으로 잃어버리는 순간이 저장되는 순간이 됩니다. 짧은 세션은 자동으로 건너뛰어지며, 2분의 용무는 메모할 가치가 없으므로 하나의 에이전트, 하나의 프로젝트 또는 모든 곳에서 프롬프트를 선택 해제할 수 있습니다.
프로젝트가 알고 있는 것을 확인하세요
그래프 보기는 메모를 목록이 아닌 지도 형태로 변환합니다.
모든 노트는 노드입니다. 폴더는 클러스터를 형성합니다. [[wiki-links]] 에이전트가 노트 본문 내에서 작성한 링크가 엣지가 되어 그래프는 폴더 트리가 아닌 프로젝트 지식의 실제 형태를 그립니다.
신선함이 시각적 요소를 주도합니다. 최근에 업데이트된 노트는 더 크고 밝으며, 몇 주 동안 손대지 않은 노트는 줄어들고 흐려집니다. 오래된 지식은 오래된 것처럼 보이며, 바로 그때 주목하고 싶습니다. 어떤 노드를 클릭하면 해당 노트를 열 수 있습니다.
프로젝트당 하나의 메모리, 개인당 하나가 아님
이것이 대부분의 메모리 도구가 잘못 이해하는 부분입니다.
대부분의 지식 도구는 모든 것을 사용자 계정에 스코프합니다: 당신의 노트, 당신의 금고, 당신의 동기화. 두 번째 사람이 참여하는 순간 그 모델은 깨지며, 중요한 지식은 당신이 아니라 프로젝트에 관한 것입니다.
AgentsRoom은 프로젝트 메모리를 리포에 커밋된 프로젝트 ID에 연결합니다. 프로젝트를 여는 모든 사람이 동일한 메모리를 읽고 씁니다. 팀원이 리포를 복제하고 열면 그들의 에이전트는 당신의 에이전트가 배운 모든 것을 상속합니다. 초대할 필요가 없고, 공유할 금고가 없으며, 내보내고 다시 가져올 필요가 없습니다.
알아두어야 할 한 가지 결과: 접근은 능력 기반입니다. 로그인하고 프로젝트 ID를 가지고 있는 것이 접근을 부여하므로 공개 리포의 메모리는 공개로 취급하십시오. 에이전트는 절대 비밀이나 기계 특정 경로를 저장하지 않도록 지시받으며, 당신도 그렇게 해야 합니다.
세 가지 도구, 그리고 에이전트가 나머지를 처리합니다
프로젝트 메모리는 MCP를 통해 에이전트에게 노출되므로 연결된 에이전트 CLI는 동일한 인터페이스를 사용합니다.
memory_list폴더와 노트를 목록화하며 검색 단서와 콘텐츠 미리보기를 제공합니다. 에이전트는 비트리비얼 작업을 시작하기 전에 이를 호출하도록 지시받습니다: 모듈이 이미 설명되어 있을 수 있습니다.
memory_getID 또는 정확한 이름으로 하나의 노트의 전체 마크다운 본문을 반환합니다. 이름은 위키 링크가 해결되는 방식이므로 에이전트는 [[a-link]]에서 한 노트에서 다음 노트로 바로 따라갈 수 있습니다.
memory_save노트를 생성하거나 업데이트합니다. 동일한 이름은 제자리에서 업데이트를 의미합니다. 이름, 검색 단서, 마크다운 본문, 선택적 폴더 및 태그를 받습니다.
디자인상 공급자에 구애받지 않음: 도구는 AgentsRoom MCP 서버에 의해 제공되므로 Claude Code, Codex CLI 및 AgentsRoom에서 실행하는 다른 에이전트 CLI는 모두 동일한 프로젝트 메모리를 읽고 씁니다.
작동 방식
설정 단계가 없습니다. 메모리는 비어 있는 상태로 시작하여 스스로 채워집니다.
당신의 에이전트가 읽기 시작합니다
첫 번째 세션부터 모든 에이전트는 코드 탐색을 시작하기 전에 프로젝트 메모리를 확인하라는 지시를 받습니다. 초반에는 아무것도 찾지 못하고 작업을 계속 진행합니다.
당신의 에이전트가 쓰기 시작합니다
첫 번째 실제 결정, 첫 번째 함정, 첫 번째 모듈이 제대로 이해됨: 에이전트가 노트를 저장합니다. 필요에 따라 폴더가 나타납니다. 도크의 뇌 아이콘에서 카운트가 증가하는 것을 지켜볼 수 있습니다.
그 이후의 모든 세션은 더 짧습니다
새로운 에이전트는 프로젝트에 대한 작업 이해를 가지고 열립니다. 같은 세 개의 단락을 작성할 필요가 없으며, 에이전트는 이미 작업한 내용을 다시 발견하기 위해 토큰을 지불할 필요가 없습니다.
어디에서 가치를 창출하는가
한 사람의 머리 속에 있던 지식, 또는 아무데도 없던 지식.
클라이언트 코드베이스를 조율하는 에이전시
각각 고유한 특성을 가진 열두 개의 클라이언트 프로젝트. 각 프로젝트는 고유한 메모리를 가지고 있으므로, 3개월 후에 다시 시작하더라도 커밋 로그에서 다시 배우지 않아도 됩니다.
온보딩, 인간 또는 에이전트
새로운 개발자가 리포를 복제하면 그들의 에이전트는 이미 아키텍처, 규칙 및 함정을 알고 있습니다. 메모리는 온보딩 문서와 같지만, 작업이 진행되는 동안 작성되었기 때문에 최신 상태입니다.
아무도 기억하지 못하는 레거시 코드
에이전트를 오래된 모듈에 지정하고 그것이 어떻게 작동하는지 파악하게 한 다음 아키텍처에 기록하게 하세요. 다음에 그것을 다루는 사람은 신비가 아닌 설명에서 시작합니다.
에이전트 간의 인수인계
PM 에이전트가 범위를 정하고, 개발 에이전트가 구축하며, QA 에이전트가 검증합니다. 각 에이전트는 배운 것을 기록하고 다음 에이전트는 이를 읽어들여 단계 간의 스레드를 잃지 않도록 합니다.
메모리, 기술 및 프롬프트는 동일한 것이 아닙니다
AgentsRoom은 세 가지 다른 질문에 답하기 위해 세 개의 라이브러리를 유지합니다.
프로젝트 메모리
이 프로젝트에 대해 무엇이 사실인가요?
에이전트가 발견한 사실: 결정, 아키텍처, 함정, 규칙, 기능 상태. 에이전트가 작성하고 전체 프로젝트와 공유하며 이 코드베이스에 특정합니다.
기술 라이브러리
이런 종류의 작업을 어떻게 수행하나요?
관련될 때 로드되는 재사용 가능한 절차: 검토 체크리스트, 마이그레이션 패턴, 접근성 감사. 프로젝트 간에 이동 가능하며 다른 도구로 내보낼 수 있습니다.
기술 라이브러리 탐색프롬프트 라이브러리
다시 무엇을 물어보려고 했나요?
자주 보내는 지침을 저장하고 정리하여 다시 입력할 필요가 없도록 합니다. 당신이 작성하고, 당신이 보냅니다.
프롬프트 라이브러리 탐색Project Memory는 에이전트 메모리에 대한 하나의 답이지 유일한 답은 아닙니다. CLAUDE.md 파일, mem0, Letta, Zep, basic-memory, MCP를 붙인 Obsidian은 각각 문제의 다른 부분을 해결합니다.
AI 에이전트 메모리 도구 비교자주 묻는 질문
AgentsRoom의 프로젝트 메모리는 무엇인가요?
프로젝트 메모리는 프로젝트에 연결된 지속적이고 공유된 지식 기반입니다. 당신의 AI 코딩 에이전트는 작업하는 동안 memory_save MCP 도구를 사용하여 노트를 작성하고, memory_list 및 memory_get으로 읽습니다. 노트는 아키텍처, 결정, 규칙, 함정 및 기능 상태를 포함합니다. 세션이 종료될 때 지워지는 에이전트의 컨텍스트 창과 달리, 메모리는 서버 측에 저장되어 세션, 재시작 및 기계를 생존합니다.
CLAUDE.md 또는 AGENTS.md 파일과는 어떻게 다른가요?
서로를 보완합니다. CLAUDE.md는 당신이 수동으로 작성하고 유지하는 정적 지침 파일입니다: 당신이 이미 알고 있는 규칙이 매 세션 시작 시 로드됩니다. 프로젝트 메모리는 동적이고 에이전트가 작성합니다: 작업하는 동안 에이전트가 배운 것을 노트별로 캡처하고, 당신이 유지 관리하지 않고도 성장합니다. 실제로 CLAUDE.md는 당신의 규칙과 명령을 보유하고, 메모리는 코드베이스에 대한 누적된 이해, 결정 및 함정을 보유합니다. AgentsRoom은 UI에서 CLAUDE.md를 편집할 수 있게 해줍니다.
내 팀원도 동일한 메모리를 보나요?
네. 프로젝트 메모리는 리포에 저장된 프로젝트 ID에 연결되어 있으며, 사용자 계정이 아니라 모든 사람이 AgentsRoom에서 프로젝트를 열면 동일한 메모리를 읽고 씁니다. 당신의 팀원이 리포를 복제하고 열면 그들의 에이전트는 당신의 에이전트가 배운 모든 것을 상속합니다. 초대, 내보내기 또는 가져올 필요가 없습니다. 접근은 능력 기반입니다: 로그인하고 프로젝트 ID를 가지고 있는 것이 접근을 부여하므로 공개 리포의 메모리는 공개로 취급하고 비밀은 포함하지 않아야 합니다.
프로젝트 메모리는 무료인가요?
네. 프로젝트 메모리는 추가 비용 없이 AgentsRoom에 포함되어 있으며 메모 제한이 없습니다. 지식 그래프에 대한 별도의 동기화 구독이나 유료 추가 기능이 없습니다. 메모리는 서버 측에 저장되므로 프로젝트의 사용자 간에 공유될 수 있도록 로그인해야 합니다.
어떤 AI 에이전트가 프로젝트 메모리를 사용할 수 있나요?
AgentsRoom 내에서 실행하는 모든 에이전트 CLI입니다. 메모리 도구는 특정 공급자에 묶이지 않고 AgentsRoom MCP 서버에 의해 제공되므로 Claude Code, Codex CLI 및 지원되는 다른 CLI는 모두 동일한 노트를 읽고 씁니다. 메모리를 IDE에 두는 이유는 에이전트를 전환해도 프로젝트의 누적 지식을 잃지 않기 위함입니다.
에이전트에게 저장하라고 지시해야 하나요?
아니요, 하지만 할 수 있습니다. 모든 에이전트는 시스템 프롬프트에서 메모리 지침을 받고 중요한 결과 후에 스스로 저장합니다. 확인 프롬프트 없이. 그 외에도 특정 에이전트에 대해 항상 기억하기를 켜면, 내구성 있는 학습이 생성된 모든 턴의 끝에서 이를 지속하게 됩니다. 활성 세션이 있는 에이전트를 종료할 때 AgentsRoom은 탭을 닫기 전에 세션을 기억할 것인지 제안합니다.
내가 직접 메모리를 읽고 편집할 수 있나요?
네. 도크의 뇌 아이콘을 클릭하면 메모리가 열리며, 존재하는 노트 수를 보여주는 배지가 표시됩니다. 폴더 사이드바, 이름, 단서, 본문 및 태그에 대한 퍼지 검색, 노트를 생성, 이름 변경, 복제 또는 삭제하고 폴더 간에 이동할 수 있는 전체 편집기가 제공됩니다. 노트를 노드로, 위키 링크를 엣지로 그리고 오래된 노트는 흐려지는 그래프 보기도 있습니다.
프로젝트 메모리는 오프라인에서도 작동하나요?
부분적으로. 데스크탑 앱은 프로젝트 폴더에 메모리의 로컬 캐시를 유지하므로 AgentsRoom UI는 연결 없이도 노트를 표시할 수 있습니다. 에이전트의 메모리 도구는 모든 호출에서 서버와 통신하므로 에이전트는 읽거나 쓰기 위해 연결이 필요합니다. 캐시 파일은 gitignore되어 있으므로 리포를 오염시키지 않습니다.
프로젝트 메모리에 포함되지 말아야 할 것은 무엇인가요?
비밀, 자격 증명, 토큰 및 기계 특정 경로. 에이전트가 받는 도구 설명은 이를 명시적으로 저장하는 것을 금지하며, 수동으로 노트를 작성할 때도 동일한 규칙을 따라야 합니다. 메모리는 프로젝트에 대한 증류된, 내구성 있는 지식에 관한 것입니다: 결정과 그 결정이 내려진 이유, 모듈이 작동하는 방식, 피해야 할 함정, 유효한 규칙. 세션 대화 및 일회성 세부 사항은 포함되지 않아야 합니다.
프로젝트 메모리를 끌 수 있나요?
네, 여러 수준에서 가능합니다. 메모리는 기본적으로 켜져 있으며, 프로젝트의 에이전트 기본값에서 단일 토글로 해당 프로젝트에 대해 끌 수 있습니다: 에이전트를 종료할 때 기억하기 프롬프트가 없고, 시스템 프롬프트에 메모리 지침이 없으며, 에이전트는 메모리 도구가 사용 불가능하다고 알려집니다. 메모리를 켜두고 종료 프롬프트만 무음으로 설정할 수도 있으며, 하나의 에이전트, 하나의 프로젝트 또는 전역적으로 설정할 수 있습니다. 끌 때 아무것도 삭제되지 않으므로 다시 켜면 이미 가지고 있던 노트를 복원합니다.
당신도 좋아할 수 있습니다
코드베이스를 다시 설명하는 것을 멈추세요
AgentsRoom을 다운로드하고 에이전트가 기억하기 시작하게 하세요. 무료, 메모 제한 없음.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.
AgentsRoom의 실제 모습.