네이밍 스키마와 감사 스크립트로 Claude Code 자동 메모리의 컨텍스트 팽창 문제 해결하기

r/ClaudeAI의 한 개발자가 몇 달간 사용 후 Claude Code의 자동 메모리에서 발생하는 메모리 드리프트와 컨텍스트 블로트를 해결하는 실용적인 스킬을 공유했습니다. 이 스킬은 파일 명명 규칙과 필수 frontmatter 필드를 적용하며, 문제를 감지하는 bash 감사 스크립트를 포함합니다.

스킬이 하는 일

Claude Code 자동 메모리(v2.1.59+)는 일반 마크다운을 ~/.claude/projects/<slug>/memory/에 기록합니다. 이 스킬은 그 위에 구조를 추가합니다. 파일은 <type>_<topic>.md 명명 규칙을 따르고, frontmatter에 name, description, type이 필요하며, 피드백 항목에는 Why 섹션이 포함되어야 합니다. 자동 메모리는 여전히 기록하지만, 스킬이 Claude가 사양에 맞게 작성하도록 합니다.

주요 기능

• 구문 트리거 검토: "Audit memory"라고 말하면 감사 스크립트가 실행됩니다. "Review session"은 최근 세션을 살펴보고 유지할 항목을 제시합니다.
• 소프트 경고: 감사는 드리프트를 보고하지만 쓰기를 차단하지 않습니다.
• 일반 마크다운: 파일은 grep, git 등으로 편집 가능합니다. 데이터베이스나 데몬이 필요하지 않습니다.

메모리에 미치는 영향

파일당 하나의 주제이므로 Claude는 첫 조회 시 올바른 항목으로 이동합니다. 중복 제거된 라이브러리는 세션당 로드되는 파일이 적어 작업 자체를 위한 컨텍스트가 확보됩니다.

샘플 감사 출력

Memory audit · 2026-05-15 · 132 files
Hard checks (must be zero):
  missing frontmatter     0
  frontmatter fields      0
  feedback missing Why    1
  naming violations       0
  broken MEMORY.md links  0
Soft signals:
  oversized files         78
  groups over 15 entries  3
  untouched 30+ days      31
  not in MEMORY.md        0
Hard-rule compliance: 99.2% (1 violation / 132 files)

설치

Claude Code 세션에 다음을 붙여넣으세요: Install the claude-memory-manager skill from https://github.com/jau123/claude-memory-manager. 그런 다음 "audit memory"라고 말하여 확인합니다.

내장 자동 메모리와의 비교

• 자동 메모리만 사용: 스키마나 감사 없음. Claude가 명명과 구조를 결정합니다.
• 이 스킬 사용: 3유형 스키마 + 필수 필드 + 피드백에 Why + 원클릭 감사 스크립트.

제한 사항

• 단일 프로젝트 범위만 가능.
• 의미론적 순위 없음 — 감사는 패턴 매칭만 수행.
• Bash 스크립트; Windows/git-bash에서는 테스트되지 않음.
• 소규모 라이브러리(약 10개 항목 미만 또는 1개월 미만)에는 과도함.