/compact-guide

name: compact-guide
description: "컨텍스트 윈도우 관리 및 토큰 최적화 가이드. Triggers on: 컨텍스트, 토큰, compact, 메모리 관리. NOT for: 코드 작성, 디버깅."
disable-model-invocation: false
user-invocable: true

컨텍스트 관리 가이드

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

핵심 원칙 (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에 맡기고 개입하지 않는다