# [Lv.4] 10000 토큰 Read 리밋 근본 해결 — 시스템 전체 영향

## 레벨: Lv.4 (3문서 + 에이전트 미팅 만장일치까지 반복)
## 한정승인: 해결책 찾을 때까지 무한 cycle. Phase 나눠서라도 해결.

---

## 문제의 심각성

Claude Code의 Read tool이 **10000 토큰 이상 파일을 읽지 못함**.
이것은 단순 불편이 아니라 **시스템 전체의 작업 품질을 떨어뜨리는 근본 원인**임.

### 영향 범위
1. **마케팅 캠페인**: 리쿠르팅 마케팅 전략서(recruiting-campaign-plan.md 등)를 팀이 못 읽음 → 전략 모르고 작업 → 팩트 오류, 조직 혼동
2. **모든 위임 작업**: 큰 spec 파일, CLAUDE.md, 전략서를 참조해야 하는 모든 작업이 불완전하게 진행됨
3. **산출물 검증 불가**: 팀이 만든 큰 결과물을 다른 팀이 읽어서 검증할 수 없음
4. **연쇄적 품질 저하**: 읽지 못한 파일 → 불완전한 이해 → 잘못된 구현 → 수정 재위임 → 토큰 낭비 악순환

### 현재 파악된 초과 파일 (task-1134.1 조사 결과)
- 109KB 이상: crisis-scenarios.md
- 51K 토큰: creative-specs.md 추정
- 34K 토큰: server.py
- 22K 토큰: 다수
- 15K 토큰: 다수
- **10K 초과 파일이 시스템 전반에 수십 개**

## 해결 방향 (에이전트 미팅에서 논의)

### 방향 1: 리밋 자체를 올릴 수 있는가?
- Claude Code 환경 변수, 설정 파일로 10000 토큰 리밋 조정 가능 여부
- MAX_MCP_OUTPUT_TOKENS (50000까지 가능하다는 정보 있음)
- Read tool 전용 리밋 설정이 있는지
- settings.json, .claude/config 등에서 조정 가능한지
- 최신 Claude Code 버전에서 이 리밋이 변경되었는지

### 방향 2: 리밋을 올릴 수 없다면 워크어라운드
- **파일 자동 분할 시스템**: 큰 파일을 자동으로 챕터/섹션별로 분할
- **목차→요약→상세 강제**: 모든 파일에 요약본 생성, 팀은 요약본 먼저 읽고 필요한 섹션만 offset/limit로 접근
- **dispatch.py 사전 체크**: 참조 파일 크기를 미리 체크하고, 초과 시 자동 분할 또는 요약본 생성
- **팀 프롬프트 강제 규칙**: "30KB+ 파일은 반드시 offset/limit 사용" 규칙을 team_prompts.py에 주입
- **스마트 리더 유틸리티**: 큰 파일을 자동으로 분할 읽기하는 래퍼 스크립트/훅

### 방향 3: 근본적 구조 변경
- 현재 큰 파일들을 모두 분할 (예: recruiting-campaign-plan.md → 채널별 4개 파일)
- 향후 생성되는 파일도 10K 토큰 이하로 유지하는 가이드라인/자동 검증
- 분할 기준: 섹션별, 채널별, 앵글별 등 논리적 단위

## task-1134.1 권고 사항 (즉시 적용 검토)
1. 팀 프롬프트에 "30KB+ 파일은 offset/limit 필수" 규칙 추가
2. dispatch.py에 참조 파일 크기 사전 체크 기능 추가
3. 109KB 이상 대형 파일 분할 검토

## 에이전트 미팅 필수 참석
- 레드팀(로키) 필수 참석
- 다양한 관점 필요: 백엔드(구현), UX(사용성), QA(검증)
- **해결책이 나올 때까지 미팅 cycle 반복** (최대 제한 없음)
- 각 cycle 후 중간 보고 파일 저장

## 산출물
1. 분석 보고서 (문제 범위 + 영향 + 데이터)
2. 해결 방안 계획서 (우선순위 + 구현 방안 + 예상 효과)
3. 즉시 적용 가능한 quick-win은 직접 실행
4. Phase별 실행 계획

## 참조
- task-1134.1 보고서: `/home/jay/workspace/memory/reports/task-1134.1.md`
- task-1123.1 보고서: `/home/jay/workspace/memory/reports/task-1123.1.md`
- settings.json: `~/.claude/settings.json`
- team_prompts.py: `/home/jay/workspace/teams/shared/team_prompts.py`
- dispatch.py: `/home/jay/workspace/dispatch.py`

## task-timer
- task_id: task-1137.1
- team: dev4-team