전략적 컴팩트 스킬
임의의 자동 컴팩션에 의존하지 않고 워크플로우의 전략적 지점에서 수동 /compact를 제안합니다.
활성화 시점
- 컨텍스트 제한에 근접하는 긴 세션을 실행할 때 (200K+ 토큰)
- 다단계 작업을 수행할 때 (조사 -> 계획 -> 구현 -> 테스트)
- 같은 세션 내에서 관련 없는 작업 간 전환할 때
- 주요 마일스톤을 완료하고 새 작업을 시작할 때
- 응답이 느려지거나 일관성이 떨어질 때 (컨텍스트 압박)
전략적 컴팩션이 필요한 이유
자동 컴팩션은 임의의 지점에서 실행됩니다:
- 종종 작업 중간에 실행되어 중요한 컨텍스트를 잃음
- 논리적 작업 경계를 인식하지 못함
- 복잡한 다단계 작업을 중단할 수 있음
논리적 경계에서의 전략적 컴팩션:
- 탐색 후, 실행 전 -- 조사 컨텍스트를 압축하고 구현 계획은 유지
- 마일스톤 완료 후 -- 다음 단계를 위한 새로운 시작
- 주요 컨텍스트 전환 전 -- 다른 작업 시작 전에 탐색 컨텍스트 정리
작동 방식
suggest-compact.js 스크립트는 PreToolUse (Edit/Write)에서 실행되며 다음을 수행합니다:
- 도구 호출 추적 -- 세션 내 도구 호출 횟수를 카운트
- 임계값 감지 -- 설정 가능한 임계값에서 제안 (기본값: 50회)
- 주기적 알림 -- 임계값 이후 25회마다 알림
Hook 설정
플러그인으로 설치한 경우: 별도 설정이 필요 없습니다. 플러그인의 hooks/hooks.json이 이미 suggest-compact.js를 등록합니다(훅 ID pre:edit-write:suggest-compact, standard 및 strict 훅 프로파일에서 활성). 아래 블록을 ~/.claude/settings.json에 복사하지 마세요 — 플러그인 설치에는 ~/.claude/scripts/가 존재하지 않으며, 플러그인 훅을 중복하면 이중 실행이 발생합니다(${CLAUDE_PLUGIN_ROOT}는 사용자 settings.json에서 해석되지 않습니다).
수동 설치(./install.sh)인 경우 ~/.claude/settings.json에 추가합니다:
{
"hooks": {
"PreToolUse": [
{
"matcher":…
