# task-179.1 완료 보고서
> 토큰 소모 개선 - 프로젝트 구조 맵 자동생성 시스템

## 작업 내용

팀 봇이 새 코딩 작업 시작 시 프로젝트 구조 파악에 소비하는 토큰을 대폭 줄이기 위한 프로젝트 구조 맵 자동생성 시스템 개발.

### 작업1: project-map.py 생성 스크립트
- `scripts/project-map.py` 신규 생성
- 프로젝트 경로 입력 → 구조 요약 Markdown 출력
- 6개 섹션: 디렉토리 트리, 타입/인터페이스, API 라우트, 컴포넌트, 설정 요약, 최근 수정 파일
- Python 표준 라이브러리만 사용, 외부 의존성 없음
- CLI: `python3 scripts/project-map.py <PATH> --output <OUT> [--depth N] [--include-tests]`

### 작업2: 팀 프롬프트 연동
- `prompts/team_prompts.py` 수정
- `_build_project_map_section()` 헬퍼 함수 추가
- project-map 파일 존재 시 프롬프트에 "프로젝트 구조 맵" 참조 경로 자동 삽입
- direct팀(dev1/dev2) 및 glm팀(dev3) 프롬프트 양쪽 모두 적용

### 작업3: 자동 갱신 훅
- `dispatch.py` 수정
- `--refresh-map` / `--no-refresh-map` 플래그 추가 (BooleanOptionalAction, 기본값: True)
- project_id 지정 + refresh_map=True 시:
  - map 파일 미존재 또는 24시간 이상 오래된 경우 → project-map.py 자동 실행
  - 최신이면 스킵

### 작업4: insuwiki 프로젝트 맵 초회 생성
- `/home/jay/projects/insuwiki/` 대상 실행 완료
- 생성 결과: `memory/project-maps/insuwiki.md` (576줄)
- 내용 검증: 48+ 타입, 27 API 라우트, 37 컴포넌트, 설정 요약, 최근 수정 파일 20건 정확 추출

## 생성/수정 파일 목록
- `scripts/project-map.py` (신규, 611줄) - 핵심 스크립트
- `prompts/team_prompts.py` (수정) - project-map 참조 삽입 로직
- `dispatch.py` (수정) - --refresh-map 플래그 + 자동갱신
- `memory/project-maps/insuwiki.md` (신규, 576줄) - insuwiki 구조 맵
- `teams/dev2/test_task_179_1.py` (신규, 22 테스트) - 테스트 코드

## 테스트 결과
- **22/22 전체 통과** (pytest, 0.11초)
- project-map.py: 빈 디렉토리, Next.js 프로젝트 시뮬, 제외 패턴, depth, include-tests (11개)
- team_prompts.py: 존재/미존재/None (5개)
- dispatch.py: 플래그 파싱, 24시간 갱신/스킵, 미존재 갱신, refresh=False (6개)

## 버그
없음

## 기대 효과
- 팀 봇 초기 구조 파악 토큰 약 50-70% 절감
- 576줄의 구조 맵으로 파일 탐색 시행착오 감소
- 일관된 프로젝트 이해 → 코드 품질 향상