Governor – a Claude Code plugin to reduce token/context waste

개요

Governor는 Claude Code의 토큰 및 컨텍스트 낭비를 줄이기 위한 플러그인으로, 에이전트를 간결하게 유지하고, 메모리 파일을 축소하며, 불필요한 로그를 필터링하고, 광범위한 작업에 대한 계획 가드레일을 추가합니다.

주요 내용

• 토큰/컨텍스트 낭비 감소: Governor는 긴 응답뿐만 아니라 Bloated context(CLAUDE.md, notes, rules 등), Bash/test/build 출력, 모호한 프롬프트로 인한 광범위한 스캔 및 반복 실패, 긴 코딩 작업 중 스코프 드리프트, 방지 가능한 컨텍스트 증가로 인한 압축 등 Claude Code의 주요 세션 킬러를 해결합니다.
• 핵심 기능:
• Always-on compact mode: 모든 Claude Code 채팅에서 응답을 간결하게 유지합니다.
• Professional memory compression: /governor:compress CLAUDE.md 명령어로 verbose 메모리 파일을 밀도 높은 산문으로 재작성합니다.
• Protected-span safety: 코드 블록, 경로, URL, 명령어 등은 압축 중에도 보존됩니다.
• Quality guard: 낮은 절감 효과의 압축은 거부되고 백업이 복원됩니다.
• Tool-output filtering: Bash/test/build 출력은 실패 신호를 보존하며 요약됩니다.
• Telemetry ledger: /governor:status 명령어로 차단된 토큰, 실패, 압축 등을 보고합니다.
• Prompt guidance: 모호한 프롬프트에 대한 부드러운 제안을 제공합니다.
• Plan and drift guard: /governor:plan 및 /governor:guard 명령어로 작업 계획 및 스코프를 관리합니다.
• 압축 방식: 타임스탬프 백업 생성, 보호 스팬 표시, 밀도 높은 산문으로 파일 재작성, 마커 제거, 보호 콘텐츠 검증, 낮은 절감 효과 시 백업 복원 등의 과정을 거칩니다.
• 벤치마크 결과: Sonnet 모델을 사용한 기술 설명 프롬프트에서 Governor는 Control 대비 약 55.5%의 출력 토큰을 절감했습니다. 메모리 압축에서도 상당한 토큰 절감 효과를 보였으며, Tool-output filtering에서는 96.8%의 토큰을 필터링했습니다.
• 설치 및 사용: bash install.sh --force 명령어로 설치 가능하며, /governor:status, /governor:audit, /governor:compress CLAUDE.md 등의 명령어를 통해 제어 및 모니터링할 수 있습니다.
• 데이터 저장: Governor는 ~/.claude/plugins/governor/ 경로에 로컬 JSONL 원장을 저장하여 차단된 토큰, 실패, 압축 등의 데이터를 추적합니다.

시사점

Governor 플러그인은 Claude Code 사용 시 발생하는 토큰 및 컨텍스트 낭비를 효과적으로 줄여 비용을 절감하고 효율성을 높일 수 있으며, 전문적이고 간결한 상호작용을 지원합니다.