CLAUSE.md 파일 압축하여 Claude 코드의 시스템 프롬프트 부풀림 줄이기

Claude 컨텍스트 사용 최적화

Claude Code는 프로젝트 수준의 CLAUDE.md 파일, ~/.claude/CLAUDE.md의 전역 파일, 지속적 메모리 시스템 파일을 포함하여 모든 대화에 CLAUDE.md 파일을 시스템 프롬프트 컨텍스트로 주입합니다. 이러한 파일의 모든 문자는 Claude가 사용자 요청을 처리하기 전에 처리하는 컨텍스트를 소비하여 신호 대 잡음비가 낮을 때 성능을 저하시킬 수 있습니다.

압축 접근법

저자는 사람이 읽을 수 있는 장식을 제거하고 기계가 읽을 수 있는 신호만 유지하는 것을 제안합니다:

• 마크다운 장식 제거: 헤더(##), 굵게(**), 기울임(*), 수평선(---)
• 설명문을 표기법으로 축약: 설명 문장 대신 간결한 키-값 쌍이나 파이프로 구분된 목록 사용
• 중복된 프레이밍 제거: "이 섹션은...을 포함합니다"나 "다음 표는...을 보여줍니다" 같은 문장 제거
• 교차 파일 컨텍스트 중복 제거: 동일한 정보를 하나의 표준 위치에만 유지
• 테이블 서식 압축: 장황한 마크다운 테이블을 간결한 표기법으로 대체

압축 전후 예시

디렉토리 인덱스 테이블 예시:

압축 전 (마크다운 테이블):

## 디렉토리
| 디렉토리 | 내용 | 읽을 시기 |
|-------------|-----------------------------|---------------------------------------|
| src/ | 애플리케이션 소스 코드 | 애플리케이션 로직 작업 시 |
| infra/ | Terraform 및 Ansible 파일 | 인프라 수정 시 |
| docs/ | 아키텍처 문서 | 시스템 설계 이해 시 |
| scripts/ | 배포 및 유틸리티 스크립트 | 배포 워크플로 실행 또는 편집 시 |

압축 후:

디렉토리: src/=애플리케이션 소스 | infra/=terraform+ansible | docs/=아키텍처 문서 | scripts/=배포+유틸리티 스크립트

메모리 시스템 지침 예시:

압축 전:

## 메모리 시스템
지속적 메모리는 `/path/to/memory/`에 위치합니다.
**세션 시작**: 이 저장소에서 실질적인 작업을 할 때 컨텍스트를 재구성하려면 `memory/_index.md`를 읽으세요.
**작업 중** — 중요한 일이 발생하면 메모리에 기록하세요:
- 발견 사항이나 명확하지 않은 발견 → `memory/discoveries.md`에 추가
- 적용되거나 학습된 새로운 기술 → `memory/skills.md` 업데이트

압축 후:

메모리: /path/to/memory/
세션-시작: 실질적인 작업 시 _index.md 읽기
작업-중 (중요한 이벤트 시에만 기록, 신호만 잡음 아님):
발견 → memory/discoveries.md 추가
학습된 기술 → memory/skills.md 업데이트

압축 결과

저자는 파일 전체에서 다음과 같은 감소를 달성했습니다:

• _index.md: 3,560 → 2,036 문자 (43% 감소)
• discoveries.md: 11,260 → 5,609 문자 (50% 감소)
• interests.md: 4,315 → 2,561 문자 (41% 감소)
• skills.md: 16,176 → 5,353 문자 (67% 감소)
• career-timeline.md: 17,882 → 5,027 문자 (72% 감소)
• ~/.claude/CLAUDE.md: 2,350 → 1,495 문자 (36% 감소)

전체 압축된 메모리 시스템: 60,264 문자로 전체적으로 약 60-70% 감소. 프로젝트 CLAUDE.md는 더욱 공격적으로 압축되었습니다.