자동 메모리와 Dreams

매번 같은 선호도와 컨텍스트를 설명하는 것은 비효율적입니다. 자동 메모리(Auto Memory) 는 Claude가 대화 중 학습한 내용을 자동으로 메모리 파일에 저장하여 다음 세션에서 즉시 활용할 수 있게 합니다.

자동 메모리란

자동 메모리는 Claude가 대화 중 중요하다고 판단한 정보를 CLAUDE.md 또는 별도 메모리 파일에 자동으로 기록 하는 기능입니다.

대화 예시:
사용자: "앞으로 항상 한국어로 응답해줘"
Claude: "알겠습니다. 앞으로 한국어로 응답하겠습니다."
       → [자동 메모리 저장: "응답 언어: 한국어"]

다음 세션에서 별도 언급 없이도 한국어로 응답합니다.

메모리 유형 4가지

자동 메모리는 내용의 성격에 따라 4가지 유형으로 분류됩니다.

1. user (사용자 정보)

사용자 자신에 관한 정보입니다.

---
type: user
---
- 이름: 홍길동
- 선호 언어: 한국어
- 응답 스타일: 간결하고 기술적으로
- 코딩 경력: 10년, Python/TypeScript 전문

2. feedback (작업 방식 피드백)

사용자가 작업 방식에 대해 제공한 피드백입니다.

---
type: feedback
---
- 코드 설명 전에 먼저 변경사항 요약 제공
- 대안 제시 시 최대 2가지로 제한
- 완성된 코드만 보여줄 것, 중간 과정 생략
- 에러 메시지는 원문 그대로 인용

3. project (프로젝트 상태)

현재 프로젝트의 상태와 진행 사항입니다.

---
type: project
---
- 현재 작업: 인증 모듈 리팩토링
- 완료: JWT 토큰 발급, 갱신 로직
- 진행 중: 소셜 로그인 (Google, GitHub)
- 대기 중: 이중 인증(2FA) 구현
- 알려진 이슈: refresh token 만료 버그 (#123)

4. reference (외부 시스템 포인터)

자주 참조하는 외부 시스템과 리소스입니다.

---
type: reference
---
- API 문서: https://api.example.com/docs
- 스테이징 서버: https://staging.example.com
- 디자인 시스템: Figma 링크 (팀 내부)
- 모니터링: Datadog 대시보드 URL

저장하지 않는 것

자동 메모리가 저장 하지 않는 내용도 중요합니다.

저장 안 함	이유
코드 패턴과 구현 세부사항	코드베이스에서 직접 읽으면 됨
Git 히스토리와 커밋 내용	Git에서 직접 조회 가능
디버깅 과정과 시행착오	결과만 필요, 과정은 불필요
CLAUDE.md에 이미 문서화된 내용	중복 저장 방지

메모리는 컨텍스트 어딘가에서 다시 찾을 수 없는 정보 만 저장합니다.

Dreams: 세션 종료 후 인사이트 추출

Dreams 는 세션이 종료될 때 전체 대화를 분석하여 장기 기억으로 보존할 가치가 있는 인사이트를 추출하는 기능입니다.

세션 종료
    │
    └─ Dreams 실행
        ├─ 전체 대화 분석
        ├─ 중요 패턴과 결정 식별
        ├─ 인사이트 추출
        │   ├─ "사용자는 함수형 프로그래밍 스타일을 선호"
        │   ├─ "이 프로젝트는 PostgreSQL + Prisma 사용"
        │   └─ "배포는 Vercel, 환경변수는 .env.local"
        └─ 메모리 파일에 저장

Dreams는 사용자가 명시적으로 말하지 않아도 행동 패턴에서 암묵적인 선호도 를 파악합니다. 사용자가 항상 함수형 접근법을 선택한다면 이를 선호도로 기록합니다.

메모리 파일 구조

자동으로 생성된 메모리 파일의 구조입니다.

---
name: "홍길동 개발 선호도"
description: "코딩 스타일과 워크플로우 선호도"
type: user
created: 2026-03-31
updated: 2026-03-31
---

## 응답 스타일
- 한국어 사용
- 기술적이고 간결한 설명
- 코드 주석은 한국어로

## 코딩 선호도
- TypeScript strict mode
- 함수형 프로그래밍
- 불변성(immutability) 원칙 준수

frontmatter에는 메모리 식별 정보, 본문에는 실제 내용을 담습니다.

MEMORY.md 인덱스

메모리 파일이 많아지면 관리가 어려워집니다. MEMORY.md는 모든 메모리 파일의 인덱스 역할을 합니다.

# 메모리 인덱스

- [개발 선호도](.claude/memory/user-preferences.md): 코딩 스타일, 응답 언어
- [프로젝트 상태](.claude/memory/project-state.md): 현재 진행 중인 기능
- [팀 컨벤션](.claude/memory/team-conventions.md): 코드 리뷰, PR 형식
- [외부 리소스](.claude/memory/references.md): API 문서, 대시보드 링크

인덱스 파일 제약

최대 200줄 : 인덱스 자체가 컨텍스트를 과도하게 소비하지 않도록
각 항목 150자 이내 : 간결한 설명으로 빠른 파악 가능

# 제약을 지킨 예시 (150자 이내)
- [auth.md]: JWT 인증, OAuth 소셜 로그인, 세션 관리 규칙. 마지막 업데이트: 인증 미들웨어 리팩토링 완료

자동 메모리 관리

자동으로 저장된 메모리를 검토하고 정리하는 방법입니다.

# 메모리 파일 위치 확인
ls .claude/memory/
ls ~/.claude/memory/

# 메모리 에디터로 직접 수정
/memory

불필요하거나 오래된 메모리는 직접 파일을 편집하거나 삭제할 수 있습니다. Claude가 자동으로 저장한 내용이 항상 정확하지는 않으므로, 주기적인 검토를 권장합니다.

퀴즈를 불러오는 중...