# 토큰 사용량 최적화 + 파일 읽기 에러 개선

## 레벨: Lv.3 (리서치 + 에이전트 미팅 필수)
## 한정승인: 끝까지 진행

---

## 문제 1: "File content exceeds maximum allowed tokens" 에러 빈발

### 증상
팀들이 작업 시 참조 파일을 읽을 때 아래 에러가 반복 발생:
```
File content (15353 tokens) exceeds maximum allowed tokens (10000).
Use offset and limit parameters to read specific portions of the file,
or search for specific content instead of reading the whole file.
```

### 조사 방향
1. **어떤 파일들이 10000 토큰을 초과하는지** 전수 조사
   - `/home/jay/workspace/memory/specs/` 하위 파일들
   - `/home/jay/workspace/memory/tasks/` 하위 파일들
   - CLAUDE.md 파일들
   - 기타 팀들이 자주 참조하는 파일들
2. **왜 이 파일들이 커졌는지** 원인 분석
   - 하나의 파일에 너무 많은 내용을 담고 있는지
   - 분리 가능한 섹션이 있는지
3. **개선 방안 도출**
   - 큰 파일 분할 (예: recruiting-campaign-plan.md → 채널별 분리)
   - 목차→요약→상세 원칙 적용 (요약 파일 + 상세 파일 분리)
   - dispatch.py 프롬프트에서 파일 참조 방식 개선 (전체 읽기 대신 필요 섹션만)
   - Read tool 호출 시 offset/limit 사용을 강제하는 가이드라인
   - 팀 프롬프트(team_prompts.py)에 "큰 파일은 offset/limit 사용" 규칙 추가 검토

## 문제 2: 토큰 사용량 증가 — 절약 방안 조사

### 배경
시스템 업그레이드(스킬 추가, 대시보드 확장, 조직 확대 등)로 토큰 사용량이 증가함. 절약 가능한 방안 조사 필요.

### 조사 방향
1. **현재 토큰 사용 패턴 분석**
   - dispatch.py가 생성하는 프롬프트 크기 분석 (team_prompts.py의 시스템 프롬프트)
   - 각 팀의 CLAUDE.md 크기 분석
   - 불필요하게 긴 프롬프트가 있는지
   - skills/ 폴더의 SKILL.md 로딩 시 토큰 소비량
2. **절약 가능 영역 식별**
   - 시스템 프롬프트 경량화 가능 여부
   - 중복 지시사항 제거
   - 대용량 참조 파일의 요약본 생성
   - Sonnet vs Opus 사용 비율 최적화
   - 불필요한 컨텍스트 전달 제거
   - hooks에서 불필요한 정보 전달 있는지
3. **구체적 절약 방안 + 예상 절감량**
   - 각 방안별 예상 토큰 절감량 추정
   - 구현 난이도 (쉬움/보통/어려움) 분류
   - 우선순위 정리 (효과 대비 구현 비용)

## 산출물
1. 분석 보고서 (문제별 원인 + 데이터 기반 분석)
2. 개선 계획서 (우선순위별 액션 아이템)
3. 즉시 적용 가능한 quick-win 항목은 직접 실행

## 참조 경로
- 시스템 프롬프트: `/home/jay/workspace/teams/shared/team_prompts.py`
- dispatch.py: `/home/jay/workspace/dispatch.py`
- 각 팀 CLAUDE.md: `/home/jay/workspace/teams/*/CLAUDE.md`
- 스킬 폴더: `/home/jay/workspace/skills/`
- specs 폴더: `/home/jay/workspace/memory/specs/`
- settings.json: `/home/jay/.claude/settings.json`
- hooks: `/home/jay/.claude/hooks/`, `/home/jay/workspace/hooks/`

## task-timer
- task_id: task-1123.1
- team: dev7-team