# Compact Guide

> 컨텍스트 윈도우 관리 및 토큰 최적화 가이드. Triggers on: 컨텍스트, 토큰, compact, 메모리 관리. NOT for: 코드 작성, 디버깅.

- Skill: `jh941213/compact-guide` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jh941213/compact-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jh941213/compact-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jh941213 (https://skillmd.com/u/jh941213)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jh941213/compact-guide

---


# 컨텍스트 관리 가이드

컨텍스트는 신선한 우유와 같습니다. **양이 아니라 신선도가 문제입니다** — 오염된 컨텍스트는 리셋이 낫습니다.

## 핵심 원칙 (1M 컨텍스트 시대)

- 토큰 잔량을 세지 않는다 — **auto-compact가 임계값을 관리한다** — 수동 /compact는 **작업 단위가 끝나는 시점에만**
- 수동 개입은 수치가 아니라 **신호** 기반으로:

| 신호 | 행동 |
|------|------|
| 작업 단위(마일스톤/스토리)가 끝났다 | /compact — 다음 단위를 깨끗하게 시작 |
| 작업 주제가 완전히 바뀐다 | /handoff → /clear — 새 세션 |
| 같은 실수 반복, 이전 결정 망각, 비논리적 응답 | 오염 신호 — /handoff → /clear (compact로는 오염이 안 씻긴다) |
| 긴 탐색/로그 출력 직후 | 작업 단위가 끝나는 시점이면 /compact, 아니면 auto-compact에 맡김 |

- 남은 컨텍스트 걱정으로 작업을 축소하거나 서두르지 않는다 — 계속 진행

## 명령어

### /compact
- 대화 내용을 요약해서 압축
- 중요한 정보는 유지, 토큰만 줄임
- 작업 흐름이 끊기지 않음

### /clear
- 완전히 초기화
- HANDOFF.md 없으면 위험!
- 깨끗하게 시작하고 싶을 때

## 권장 패턴

```
작업 시작
    ↓
작업 단위 완료 (마일스톤/스토리)
    ↓
/compact (단위 경계에서 정리)
    ↓
… 반복 …
    ↓
주제 전환 or 오염 신호
    ↓
/handoff (HANDOFF.md 생성)
    ↓
/clear (초기화)
    ↓
새 세션에서 HANDOFF.md 읽기
```

## 비용 관점의 컨텍스트 관리

### /compact가 유리한 이유
- 작업 맥락(진행 상황·결정사항)이 요약으로 유지되어 다시 쌓을 필요가 없음
- 중요 정보는 남기고 토큰만 줄이므로 작업 흐름이 끊기지 않음
- /clear보다 재시작 비용이 낮음

### /clear의 숨겨진 비용
- 대화 컨텍스트 재구축 비용 — 진행 상황·결정사항·탐색 결과를 처음부터 다시 쌓아야 함
- HANDOFF.md 로드 시 추가 토큰 발생
- HANDOFF.md에 담기지 않은 암묵적 맥락은 유실됨

### 판단 기준
- **비용만 보면**: /compact > /clear
- **품질이 흔들리면**: /clear가 정답 — 오염된 컨텍스트를 요약하면 오염도 요약된다
- 장시간 자율 실행(TTH/autodev)은 auto-compact에 맡기고 개입하지 않는다