EliaAlberti/cpr-compress-preserve-resume

해결하는 문제

Claude Code는 세션 간에 지속적인 메모리가 없어 사용자가 세션을 다시 시작할 때마다 프로젝트의 맥락, 결정 사항, 수정 내용을 다시 설명해야 합니다. 또한 표준적인 컨텍스트 압축은 중요한 세부 정보를 평탄화하여 세심한 결정이나 특정 파일 경로가 시간이 지남에 따라 사라지게 됩니다.

작동 방식

CPR은 Claude Code용 플러그인으로, 큐레이션된 세션 로그와 자동 훅 시스템을 구현합니다:

• 큐레이션된 로그: /cpr:compress를 사용하면 의사결정, 학습 내용, 보류 중인 작업의 요약을 포함하는 구조화된 마크다운 파일이 생성됩니다. Python 스크립트를 통해 원본 대화 트랜스크립트를 추가함으로써 모델 토큰을 낭비하지 않습니다.
• 자동 훅: PreCompact 훅은 압축이 발생하기 전에 원본 트랜스크립트를 자동으로 저장하고, SessionStart 훅은 새로운 세션에 간단한 메모리 요약을 자동으로 삽입합니다.
• 컨텍스트 복원: /cpr:resume 명령어를 통해 최근 컨텍스트를 복원하거나, 요약과 원본 로그 양쪽에서 주제별로 과거 세션을 검색할 수 있습니다.
• 지식 보존: /cpr:preserve 명령어는 주요 아키텍처 결정 및 패턴을 CLAUDE.md 파일에 업데이트하여 향후 모든 세션에 지속적으로 유지합니다.

대상 사용자

여러 번의 Claude Code 세션을 통해 동일한 프로젝트를 작업하는 개발자로서, 반복적인 컨텍스트 설정을 피하고 작업 상태의 검색 가능한 기록을 유지하고자 하는 사람.

주요 특징

• 토큰 효율성: 수동 재설명을 컴팩트한 요약으로 대체함으로써 세션 재시작 시 토큰 비용을 약 51~74% 감소시킵니다.
• 검색 가능한 기록: 모델의 컨텍스트 창에 로드되지 않고도 주제별로 검색 가능한 원본 트랜스크립트 전체 아카이브를 유지합니다.
• 자동 안전망: PreCompact 훅은 자동 또는 수동 압축 중 원본 대화 데이터가 손실되지 않도록 보장합니다.
• 사용자 정의 저장소: 설정 파일을 통해 로그를 특정 디렉터리로 라우팅하거나 여러 폴더에 미러링할 수 있습니다.