Memory Systems: Persistent Context Across Sessions

Auto-memory 파일들은 다음 위치에 저장된다:

~/.claude/projects/<sanitized-cwd>/memory/
├── MEMORY.md           ← 인덱스 파일 (항상 컨텍스트에 로드됨)
├── user_role.md        ← 사용자 역할/선호도
├── feedback_testing.md ← 테스트 전략 피드백
├── project_auth.md     ← 인증 관련 프로젝트 결정
└── reference_linear.md ← Linear 티켓 추적 참조

MEMORY.md는 특별하다 — 항상 컨텍스트 윈도우에 로드된다. 이 파일은 인덱스로만 사용되며, 각 메모리의 한 줄 요약과 파일 링크를 담는다. 200줄 이후는 잘리므로 간결하게 유지해야 한다.

개별 메모리 파일은 관련성이 있을 때만 로드된다 — 컨텍스트를 아낀다.

설정으로 메모리 위치를 커스터마이즈할 수 있다:

{
  "autoMemoryDirectory": "~/my-custom-memory/"
}

메모리 파일에는 4가지 타입이 있으며, 각각 다른 목적을 가진다:

1. user — 사용자의 역할, 선호도, 지식 수준

---
name: user-role
description: 사용자가 Go 전문가이며 React는 처음임을 기록
metadata:
  type: user
---
10년 경력 Go 엔지니어. 이 프로젝트의 React 프론트엔드는 처음이다.
프론트엔드 설명 시 Go 개념과 비교해서 설명하면 효과적이다.

2. feedback — 접근 방식에 대한 사용자 교정/확인

---
metadata:
  type: feedback
---
테스트에서 DB를 mock하지 말 것.
**Why:** 지난 분기에 mock 테스트 통과 후 프로덕션 마이그레이션이 실패한 사건이 있었음.
**How to apply:** 통합 테스트는 항상 실제 DB 사용.

3. project — 진행 중인 작업, 목표, 결정 사항

---
metadata:
  type: project
---
2026-07-01까지 인증 미들웨어 재작성 완료 목표.
**Why:** Legal이 세션 토큰 저장 방식이 새 컴플라이언스 요구사항 미충족을 지적함.
**How to apply:** 인증 관련 스코프 결정은 컴플라이언스 우선.

4. reference — 외부 시스템의 위치 정보

---
metadata:
  type: reference
---
파이프라인 버그는 Linear 프로젝트 'INGEST'에서 추적됨.

메모리에 저장해야 하는 것:

• 사용자의 역할, 전문 분야, 새로운 기술 분야
• 사용자가 접근 방식을 수정하거나 확인한 것 ('이렇게 하지 마세요', '네 정확해요')
• 진행 중인 프로젝트의 결정과 맥락
• 외부 시스템 참조 (어떤 버그 트래커, 어떤 채널)

메모리에 저장하지 말아야 하는 것 (이것들은 다른 방법으로 관리한다):

기억해야 할 핵심 테스트: '이 정보를 미래의 Claude가 현재 파일을 보지 않고도 알아야 하는가?' 그렇다면 메모리에. 아니라면 코드나 git에.

MEMORY.md는 항상 컨텍스트에 로드되므로 가볍게 유지하는 것이 중요하다.

# Memory Index

## User
- [User Role](user_role.md) — Go 전문가, React 초보; 프론트엔드 설명 시 Go 비교법 효과적

## Feedback  
- [Testing Strategy](feedback_testing.md) — DB mock 금지; 작년 migration 실패 사건
- [Response Style](feedback_style.md) — 요약 금지, diff를 직접 읽을 수 있음

## Project
- [Auth Rewrite](project_auth.md) — 2026-07-01 데드라인; compliance 요구사항
- [Current Sprint](project_sprint.md) — JWT 미들웨어 구현 중

## Reference
- [Bug Tracker](reference_bugs.md) — Linear 'INGEST' 프로젝트
- [Monitoring](reference_monitoring.md) — grafana.internal/d/api-latency

각 항목은 한 줄, 150자 이내. 파일 링크와 핵심 내용을 담는다.

유지관리 전략: 메모리 파일이 오래되거나 틀려지면 즉시 업데이트하거나 삭제하라. stale한 메모리는 없는 것보다 나쁘다 — Claude가 잘못된 가정으로 작업할 수 있다. 메모리 파일을 읽기 전에 현재 코드 상태와 대조해 여전히 유효한지 확인하는 습관을 들여라.