# task-1134.1 완료 보고서

## SCQA

**S**: 대시보드에서 `/api/mktingauto` 호출 시 404 에러가 발생하며, 팀들이 큰 파일(15K~51K 토큰)을 Read tool로 읽을 때 10000 토큰 리밋 초과 에러가 반복 발생한다.

**C**: mktingauto API는 `parse_mktingauto_todo()` 메서드가 존재하지만 `do_GET` 핸들러에 라우트가 없어 404 반환. 10000 토큰 리밋은 Claude Code의 Read tool에 하드코딩된 제한으로, 환경변수나 설정으로 변경 불가. 28개 파일이 이 리밋을 초과하여 작업 품질 저하의 근본 원인이 됨.

**Q**: mktingauto API를 복구하고, Read tool 토큰 리밋 문제의 실용적 워크어라운드를 마련할 수 있는가?

**A**: (1) server.py에 `/api/mktingauto` 라우트 추가로 404 해결, pytest 47건 전체 통과. (2) Read tool 리밋 조사 결과 하드코딩(변경 불가) 확인, 워크어라운드로 파일 크기 체커 유틸리티(`file_size_checker.py`) 작성 + 28개 초과 위험 파일 전수조사 완료. 팀 프롬프트에 offset/limit 규칙 추가 권고.

---

## 수행 내용

### 문제 1: /api/mktingauto 404 에러 수정

- **수정 파일**: `dashboard/server.py:2914-2918`
- **변경 내용**: `do_GET` 핸들러에 `/api/mktingauto` 라우트 추가
- **패턴**: 기존 `/api/todo`, `/api/skills` 등과 동일한 패턴 (reload_all → parse → send_api_response)
- **테스트**: pytest 40건(test_mktingauto_api.py) + 7건(test_server.py) 전체 통과

### 문제 2: 10000 토큰 Read tool 리밋 조사

#### 조사 결과

1. **Read tool 리밋은 하드코딩**: Claude Code 바이너리에 내장, 설정 변경 불가
2. **`MAX_MCP_OUTPUT_TOKENS`**: MCP 도구 전용, Read tool에는 적용 안 됨
3. **`~/.claude/settings.json`**: Read tool 리밋 관련 설정 항목 없음
4. **`claude config`**: Read tool 리밋 조정 기능 미제공
5. **`CLAUDE_CODE_MAX_OUTPUT_TOKENS`**: 출력 토큰 리밋 전용 (현재 64000)
6. **GitHub 상태**: issue #14888 (동적 리밋 요청) 오픈 상태, issue #4002/15687 닫힘

참조 소스:
- GitHub issue #4002: https://github.com/anthropics/claude-code/issues/4002
- GitHub issue #14888: https://github.com/anthropics/claude-code/issues/14888
- GitHub issue #15687: https://github.com/anthropics/claude-code/issues/15687

#### 워크어라운드 구현

1. **파일 크기 체커 스크립트** (`teams/dev7/file_size_checker.py`)
   - `check`: 단일 파일 토큰 초과 여부 판단
   - `scan`: 디렉토리 전체 스캔 → 초과 파일 목록
   - `guide`: 큰 파일에 대한 offset/limit 분할 가이드 출력

2. **28개 초과 위험 파일 전수조사** (`teams/dev7/file-size-analysis.md`)
   - 최대: `crisis-scenarios.md` (109.6KB, ~36,500 토큰)
   - 주요 집중 디렉토리: `memory/plans/recruiting-marketing/exec/` (10개), `memory/specs/` (10개)
   - `memory/tasks/`, `teams/*/CLAUDE.md`는 모두 리밋 이하

#### 권고 사항 (미구현 - 아누 판단 필요)

1. **팀 프롬프트에 규칙 추가**: "30KB 초과 파일은 offset/limit 사용 필수"
2. **dispatch.py 사전 체크**: 참조 파일 크기 체크 → 경고 or 자동 offset/limit 지정
3. **대형 파일 분할**: 109KB `crisis-scenarios.md` 등을 시나리오별로 분할 검토

---

## 생성/수정 파일 목록

- **수정**: `dashboard/server.py` — `/api/mktingauto` 라우트 추가 (5줄)
- **신규**: `teams/dev7/file_size_checker.py` — 파일 크기 체커 유틸리티
- **신규**: `teams/dev7/file-size-analysis.md` — 28개 초과 위험 파일 분석 보고서

---

## 발견 이슈 및 해결

### 자체 해결 (3건)

1. **server.py Pyright 경고 9건** — 모두 기존 코드의 미사용 변수 (본 작업 범위 외, 수정 불필요)
2. **file_size_checker.py `os` import 미사용** — 제거 완료 (`file_size_checker.py:12`)
3. **style_check WARN (black/isort)** — server.py의 기존 스타일 이슈 (본 작업에서 추가한 코드는 기존 패턴 준수)

### 범위 외 미해결 (1건)

1. **Read tool 리밋 근본 해결** — Claude Code 바이너리 제한으로 외부에서 변경 불가. GitHub issue #14888 동적 리밋 기능 구현 대기 필요. 범위 외 사유: Anthropic 측 변경 필요

---

## 테스트 결과

- `test_mktingauto_api.py`: 40/40 통과 (0.11s)
- `test_server.py`: 7/7 통과 (0.22s)
- pyright: 0 errors, 0 warnings (check-files 대상)

---

## QC 자동 검증

```
4 PASS, 0 FAIL, 6 SKIP, 1 WARN
- pyright_check: PASS (0 errors)
- test_runner: PASS (7 passed)
- data_integrity: PASS
- file_check: PASS
- style_check: WARN (server.py 기존 스타일 이슈)
```