$npx -y skills add smorky850612/Aurakit --skill aura-guard토큰 예산 모니터. 컨텍스트 사용량 감시 및 컴팩트 방어 시스템 지원. Internal skill — not user-invocable.
| 1 | # AuraKit Guard — 컴팩트 방어 시스템 |
| 2 | |
| 3 | > 컨텍스트 창 과부하를 방지하는 자동 방어 레이어. |
| 4 | > 이 스킬은 내부적으로 동작하며 사용자가 직접 호출하지 않는다. |
| 5 | |
| 6 | --- |
| 7 | |
| 8 | ## 컴팩트 방어 아키텍처 |
| 9 | |
| 10 | ``` |
| 11 | 세션 시작 |
| 12 | │ |
| 13 | ▼ |
| 14 | 컨텍스트 사용량 모니터링 |
| 15 | │ |
| 16 | ├─ 65% 미만 → 정상 작업 계속 |
| 17 | │ |
| 18 | └─ 65% 도달 ─────────────────────────────────────────┐ |
| 19 | │ |
| 20 | CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=65 |
| 21 | │ |
| 22 | ▼ |
| 23 | pre-compact-snapshot.sh (PreCompact hook) |
| 24 | ├─ 현재 스냅샷 백업 |
| 25 | ├─ transcript 요약 (claude -p) |
| 26 | └─ .aura/snapshots/current.md 저장 |
| 27 | │ |
| 28 | ▼ |
| 29 | /compact 자동 실행 |
| 30 | │ |
| 31 | ▼ |
| 32 | post-compact-restore.sh (PostCompact hook) |
| 33 | ├─ .aura/snapshots/current.md 읽기 |
| 34 | └─ 내용을 stdout → Claude 컨텍스트 주입 |
| 35 | │ |
| 36 | ▼ |
| 37 | 새 컨텍스트에서 이전 상태 복구됨 |
| 38 | ``` |
| 39 | |
| 40 | --- |
| 41 | |
| 42 | ## 환경변수 설정 |
| 43 | |
| 44 | ```bash |
| 45 | # ~/.bashrc 또는 ~/.zshrc에 추가 (init.sh가 자동 추가) |
| 46 | export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=65 |
| 47 | ``` |
| 48 | |
| 49 | 이 설정으로 컨텍스트 65% 시점에 자동 컴팩트가 트리거된다. |
| 50 | 기본값(90%)보다 일찍 압축하여 컨텍스트 손실을 방지한다. |
| 51 | |
| 52 | --- |
| 53 | |
| 54 | ## 토큰 사용량 확인 방법 |
| 55 | |
| 56 | Claude Code에서 `/context` 명령으로 현재 컨텍스트 사용량을 확인할 수 있다. |
| 57 | |
| 58 | ``` |
| 59 | /context → 현재 토큰 사용량 및 남은 용량 표시 |
| 60 | ``` |
| 61 | |
| 62 | --- |
| 63 | |
| 64 | ## Hook 연동 |
| 65 | |
| 66 | | Hook 이벤트 | 파일 | 동작 | |
| 67 | |------------|------|------| |
| 68 | | PreCompact | pre-compact-snapshot.sh | 스냅샷 저장 | |
| 69 | | PostCompact | post-compact-restore.sh | 스냅샷 복구 + 컨텍스트 주입 | |
| 70 | |
| 71 | --- |
| 72 | |
| 73 | ## 스냅샷 파일 관리 |
| 74 | |
| 75 | ``` |
| 76 | .aura/snapshots/ |
| 77 | ├── current.md ← 가장 최신 스냅샷 (항상 덮어씀) |
| 78 | ├── SNAPSHOT-20250115-143022.md ← 이전 스냅샷 백업 |
| 79 | ├── SNAPSHOT-20250115-152841.md |
| 80 | └── ... |
| 81 | ``` |
| 82 | |
| 83 | - `current.md`: 현재 작업 상태. PostCompact 후 컨텍스트에 주입됨 |
| 84 | - `SNAPSHOT-*.md`: 자동 백업. 수동 복구 시 참조 |
| 85 | |
| 86 | --- |
| 87 | |
| 88 | ## 토큰 절약 원칙 (AuraKit 전체) |
| 89 | |
| 90 | | 원칙 | 절감량 | |
| 91 | |------|--------| |
| 92 | | Hook-First (bash hook으로 검증) | ~60% | |
| 93 | | Context:fork 에이전트 격리 | ~25% | |
| 94 | | Fail-Only 출력 | ~10% | |
| 95 | | Progressive Disclosure | ~5% | |
| 96 | |
| 97 | --- |
| 98 | |
| 99 | *AuraKit — Context Budget Guard: 65% 방어선으로 무손실 작업 보장* |