메모리 관리

MEMORY.md를 200줄 이내로 간결하고, 정확하게, 실제 파일과 동기화된 상태로 유지한다. 모든 세션은 MEMORY.md를 완전하고 최신인 인덱스로 신뢰할 수 있어야 한다.

프로젝트 우선 원칙: 프로젝트의 CLAUDE.md에 ## 메모리 운용 수칙 섹션이 있으면, 그 분류 기준과 임계값이 아래 기본값보다 우선한다. CLAUDE.md를 먼저 읽고 거기서 정의된 파일 역할 테이블과 한계값을 적용한다. 프로젝트 수준 규칙이 없을 때만 아래 기본값을 사용한다.

파일 역할

메모리 유형 (auto-memory 시스템 기준)

토픽 파일 생성 시 올바른 frontmatter 유형을 사용한다:

각 토픽 파일에는 frontmatter 필수: name, description (관련성 매칭이 가능할 만큼 구체적), type.

실행 시점

이 스킬은 세 가지 모드를 다룬다:

모드 A: 세션 시작 정합성 확인

매 세션 시작 시 다른 메모리 작업 전에 실행한다.

1. 디렉토리 스캔: Glob memory/* — 모든 파일 목록 확인
2. MEMORY.md 읽기 — 모든 링크/참조 확인
3. 교차 검증:
   • 디렉토리에 있지만 MEMORY.md에 없는 파일 → 읽고 인덱스에 추가
   • MEMORY.md에 링크가 있지만 파일이 존재하지 않는 것 → 죽은 링크 제거
4. 발견된 불일치 보고 및 수정

이 단계는 다른 세션에서 파일을 만들었지만 인덱스에 반영되지 않은 "고아 파일" 문제를 방지한다.

모드 B: 메모리 저장·수정

세션 중 메모리 파일을 생성하거나 수정할 때:

1. 토픽 파일 작성 — 올바른 frontmatter 포함
2. MEMORY.md에 링크 추가 — 해당 섹션 아래
3. MEMORY.md 200줄 미만 유지 확인

MEMORY.md 수정 시:

• 전체 파일을 먼저 읽는다 — 다른 섹션을 지우는 부분 교체 금지
• 추가·수정만 — 기존 내용이 오래된 것을 확인하기 전까지 삭제 금지
• TODO 목록 수정: 항목을 잃지 않으려면 전체 TODO 섹션을 먼저 읽고 수정

모드 C: 정리 / 세션 종료

세션이 중요한 작업을 마쳤거나 명시적으로 정리를 요청받았을 때 실행:

1. 감사 — 디렉토리를 스캔하고 각 토픽 파일을 분류:

2. MEMORY.md가 180줄 초과 시 압축:
   • 장황한 섹션 단축, 테이블 압축
   • 오래된 정보 제거 (포기된 접근법, 해결된 버그)
   • 토픽 파일 링크는 파일에 MEMORY.md보다 유의미하게 더 많은 내용이 있을 때만 유지
3. session_log.md가 200줄 초과 시 아카이브:
   • 가장 최근 5개 세션보다 오래된 항목을 session_log_archive.md로 이동
   • session_log_archive.md는 추가만 가능(append-only)으로 유지
4. 최종 확인: MEMORY.md 200줄 미만, 모든 링크 유효, 모든 파일 인덱싱

규칙

• 다른 곳에 기록되지 않은 정보는 절대 삭제하지 않는다 — 먼저 병합, 그 다음 삭제
• session_log.md 항목은 절대 수정하지 않는다 — 추가만 가능 (기록은 신성하다)
• 삭제 전 항상 사용자에게 보여준다
• 쓰기 전 읽는다 — MEMORY.md를 편집하기 전 항상 전체를 읽어 다른 세션의 변경을 덮어쓰지 않도록 한다
• 상대적 날짜 → 절대 날짜 — "목요일"을 저장할 때 "2026-03-05"로 변환, 나중에도 해석 가능하게

흔한 실수