# 토큰 절약 Phase 1 — Team 2 작업

## 작업 1: TDD SKILL.md 슬리밍

### 현재 상태
- `/home/jay/workspace/skills/tdd-enforcement/SKILL.md` (667줄, 21.5KB, ~5,400 토큰)
- DIRECT-WORKFLOW.md에 이미 TDD 규칙 요약(8줄)이 있음
- TDD skill은 `~/.claude/skills/tdd-enforcement/SKILL.md`로 로딩될 때 전체가 컨텍스트에 들어감
- 667줄 중 대부분이 예제/설명이며, 핵심 규칙은 30줄 이내

### 변경 사항

#### 1-1. SKILL.md 슬리밍

현재 667줄을 **100줄 이내**로 압축:

**유지할 내용** (핵심):
- RED-GREEN-REFACTOR 사이클 정의 (3줄)
- 적용 기준: Lv.2+ 코딩 작업만, Lv.1/문서/설정 제외 (2줄)
- 테스트 파일 명명: `test_<module>.py` / `<module>.test.ts` (1줄)
- 순서: 테스트 작성 → 실패 확인(RED) → 최소 구현(GREEN) → 리팩터 (3줄)
- audit-trail 기록 규칙 (어떤 파일이 먼저 수정되었는지 tdd_check verifier가 검증) (3줄)
- 예외 케이스: 기존 테스트 있으면 케이스 추가 방식 (2줄)

**제거할 내용**:
- 긴 예제 코드 블록들 (Python/TypeScript 각 예제)
- 상세 설명/배경/철학 (이미 팀원들이 TDD를 알고 있음)
- 중복: DIRECT-WORKFLOW.md의 TDD 규칙과 겹치는 부분

**별도 보관**: 제거하는 예제/상세 내용은 `SKILL-EXAMPLES.md`로 분리 보관 (참조용, 자동 로딩 안 됨)

#### 1-2. 기존 SKILL.md 백업

작업 전에 현재 SKILL.md를 `SKILL.md.bak`으로 백업하세요.

---

## 작업 2: project-map depth 기본값 변경

### 현재 상태
- `/home/jay/workspace/scripts/project-map.py` (1574줄)
- `--depth` 옵션 기본값: 3
- InsuWiki 프로젝트 맵이 depth 3으로 생성 시 ~900줄 (~30.9KB, ~7,700 토큰)
- depth 2로 줄이면 약 60% 감소 예상

### 변경 사항

#### 2-1. project-map.py depth 기본값 변경

```python
# 현재
parser.add_argument("--depth", type=int, default=3, help="디렉토리 트리 깊이 (기본값: 3)")

# 변경
parser.add_argument("--depth", type=int, default=2, help="디렉토리 트리 깊이 (기본값: 2)")
```

#### 2-2. 기존 프로젝트 맵 재생성

depth 변경 후 기존 프로젝트 맵을 재생성:

```bash
# InsuWiki 프로젝트 맵 재생성
python3 /home/jay/workspace/scripts/project-map.py /home/jay/projects/insuwiki --output /home/jay/workspace/memory/project-maps/insuwiki.md --depth 2
```

다른 프로젝트 맵이 있으면 모두 재생성:
```bash
ls /home/jay/workspace/memory/project-maps/
```

#### 2-3. 프로젝트 맵 크기 검증

재생성 후 줄 수 비교:
- 이전: `wc -l` 결과 기록
- 이후: `wc -l` 결과 기록
- 절감률 계산

---

## 테스트

### TDD SKILL.md
1. 슬리밍 후 100줄 이내 확인: `wc -l SKILL.md`
2. 핵심 키워드 존재 확인: RED, GREEN, REFACTOR, Lv.2, test_, audit-trail
3. SKILL-EXAMPLES.md에 예제 코드 보존 확인
4. 기존 tdd_check verifier 테스트 통과 확인: `python3 -m pytest /home/jay/workspace/teams/dev1/qc/verifiers/ -v -k tdd` (관련 테스트 있으면)

### project-map.py
1. `--depth 2` 기본값 확인: `python3 project-map.py --help | grep depth`
2. InsuWiki 맵 재생성 성공
3. 줄 수 감소 확인 (목표: 60% 이상 감소)
4. 기존 project-map 테스트 있으면 통과 확인

## QC 기준
- pyright 0 errors (project-map.py)
- black + isort 적용
- 기존 테스트 깨지지 않음