피드로 돌아가기
Dev.toAI/ML
원문 읽기
MEMORY.md 도입을 통한 세션 간 컨텍스트 유지 및 컨텍스트 낭비 제거
Claude Code Forgets Everything Between Sessions. MEMORY.md Fixes That
AI 요약
Context
Claude Code의 세션 초기화 특성으로 인해 매 세션마다 프로젝트 상태를 재설명해야 하는 컨텍스트 손실 발생. CLAUDE.md의 정적 규칙만으로는 동적인 마이그레이션 상태나 최신 의사결정 사항을 추적하기 어려운 한계 존재.
Technical Solution
- Evolving State 관리를 위한 전용 인덱스 파일인 MEMORY.md 설계
- 상세 구현체 대신 파일 경로와 핵심 결정 사항만 담는 Pointer 기반의 데이터 구조 채택
- 200라인 및 25KB라는 엄격한 용량 제한을 통한 Context Window 오버헤드 방지
- 정적 규칙(CLAUDE.md)과 동적 상태(MEMORY.md)를 분리하여 정보 갱신 주기 최적화
- 세션 종료 시점에 LLM이 스스로 MEMORY.md를 업데이트하는 피드백 루프 구축
- 과도한 정보 주입 시 발생하는 성능 저하를 막기 위해 항목당 150자 이내의 제약 조건 적용
실천 포인트
- 프로젝트 루트에 MEMORY.md 생성 및 5~10개의 핵심 Pointer 항목 작성 - 각 항목을 '상태-위치-결정사항' 순의 150자 이내 단문으로 구성 - 세션 종료 전 "Update MEMORY.md with what you learned this session" 프롬프트 실행 - 150라인 초과 시 안정화된 항목을 CLAUDE.md로 이전하고 해결된 항목 삭제