Workspace Memory 워크스페이스 메모리

Overview 개요

Workspace Memory automatically saves important workspace knowledge — bug postmortems, architectural decisions, and compact notes — and injects relevant memories into future agent prompts so the agent avoids rediscovering prior context. Each workspace has an isolated memory store that persists across sessions and survives context compaction.

워크스페이스 메모리는 중요한 워크스페이스 지식 — 버그 포스트모템, 아키텍처 결정, 간결한 메모 — 을 자동으로 저장하고, 이전 문맥을 재발견하지 않도록 관련 메모리를 향후 에이전트 프롬프트에 주입합니다. 각 워크스페이스에는 세션 간에 지속되고 컨텍스트 컴팩션에서도 유지되는 격리된 메모리 저장소가 있습니다.

Architecture 아키텍처

Storage is per-workspace. The memory directory lives under the agent's data root, keyed by an encoded version of the working directory path.

저장소는 워크스페이스별입니다. 메모리 디렉토리는 에이전트 데이터 루트 아래에 작업 디렉토리 경로의 인코딩된 버전을 키로 하여 위치합니다.

Files 파일

Recall Pipeline 리콜 파이프라인

The recall pipeline is designed for zero-token overhead during ranking:

리콜 파이프라인은 랭킹 중 토큰 오버헤드가 없도록 설계되었습니다:

1. Load lightweight index (summaries + tags only, no full content) 경량 인덱스 로드 (요약 + 태그만, 전체 콘텐츠 없음)
2. Local keyword filter extracted from recent conversation text (zero token cost) 최근 대화 텍스트에서 추출한 로컬 키워드 필터 (토큰 비용 없음)
3. Score-based ranking (local computation) 점수 기반 랭킹 (로컬 계산)
4. Load full content for top-K memories only 상위 K개 메모리에 대해서만 전체 콘텐츠 로드

Memory Templates 메모리 템플릿

Three templates define the structure of saved memories. The template is auto-detected from the content or can be specified manually.

세 가지 템플릿이 저장된 메모리의 구조를 정의합니다. 템플릿은 콘텐츠에서 자동 감지되거나 수동으로 지정할 수 있습니다.

Saving Memories 메모리 저장

Memories are saved via the memory_save tool or the /memory save slash command. The agent also auto-detects important moments (bug fixes, decisions, discoveries) and suggests saving them.

메모리는 memory_save 도구 또는 /memory save 슬래시 명령을 통해 저장됩니다. 에이전트는 중요한 순간(버그 수정, 결정, 발견)을 자동으로 감지하여 저장을 제안하기도 합니다.

Tool Parameters 도구 파라미터

Recalling Memories 메모리 리콜

Before each agent turn, the recall pipeline extracts keywords from recent conversation text, ranks memories by relevance, and injects the top results into the system prompt.

각 에이전트 턴 전에 리콜 파이프라인이 최근 대화 텍스트에서 키워드를 추출하고, 관련성별로 메모리를 랭킹하여 상위 결과를 시스템 프롬프트에 주입합니다.

Limits 제한

Scoring Formula 점수 공식

Relevance Matching 관련성 매칭

Eviction 축출

When the memory count exceeds MAX_MEMORIES (200), the system evicts the lowest-scoring memories. All scores are recalculated, memories are sorted by score ascending (tie-break: createdAt ascending — oldest first), and the overflow is removed.

메모리 수가 MAX_MEMORIES(200)을 초과하면 시스템은 점수가 가장 낮은 메모리를 축출합니다. 모든 점수가 재계산되고, 점수 오름차순으로 정렬되며(동점 시 createdAt 오름차순 — 가장 오래된 것 우선), 초과분이 제거됩니다.

Slash Commands 슬래시 명령어

Configuration 구성

No environment variables or configuration files are required. Workspace Memory operates automatically with per-workspace isolation — each working directory gets its own independent memory store under the agent's data directory.

환경 변수나 구성 파일이 필요하지 않습니다. 워크스페이스 메모리는 자동으로 작동하며 워크스페이스별 격리를 제공합니다 — 각 작업 디렉토리는 에이전트 데이터 디렉토리 아래에 자체 독립적인 메모리 저장소를 갖습니다.

Edge Cases 엣지 케이스

• Large memories: Individual memories are truncated at MAX_RECALL_MEMORY_CHARS (2000 chars). Total recalled context is bounded by MAX_RECALL_CONTEXT_CHARS (8000 chars). Truncated memories include a [Memory truncated to fit prompt budget] marker.

  큰 메모리: 개별 메모리는 MAX_RECALL_MEMORY_CHARS(2000자)에서 잘립니다. 전체 리콜 컨텍스트는 MAX_RECALL_CONTEXT_CHARS(8000자)로 제한됩니다. 잘린 메모리에는 [Memory truncated to fit prompt budget] 마커가 포함됩니다.

• Cross-workspace isolation: Each workspace is isolated by its encoded cwd path. Memories saved in one project are never visible in another.

  워크스페이스 간 격리: 각 워크스페이스는 인코딩된 cwd 경로로 격리됩니다. 한 프로젝트에 저장된 메모리는 다른 프로젝트에 표시되지 않습니다.

• Compaction survival: Memories persist across context compaction. They are stored on disk as separate JSON files, independent of the conversation context window.

  컴팩션 생존: 메모리는 컨텍스트 컴팩션 전반에 걸쳐 지속됩니다. 대화 컨텍스트 윈도우와 독립적으로 별도의 JSON 파일로 디스크에 저장됩니다.

• Orphan cleanup: If a memory file is missing or corrupted, the recall pipeline automatically removes the orphaned index entry.

  고아 정리: 메모리 파일이 누락되거나 손상된 경우, 리콜 파이프라인이 자동으로 고아 인덱스 항목을 제거합니다.

• Index caching: The index is cached in memory per session. File changes from external processes are not reflected until cache invalidation (session restart).

  인덱스 캐싱: 인덱스는 세션당 메모리에 캐시됩니다. 외부 프로세스의 파일 변경은 캐시 무효화(세션 재시작)까지 반영되지 않습니다.