# task-285.1 보고서: LangSmith CLI Skills 벤치마크 → 토큰 효율화 도입

**팀**: dev2-team (오딘)
**작업일**: 2026-03-06
**작업 유형**: research + coding (Lv.2)

## 작업 내용

LangSmith CLI Skills의 Progressive Disclosure 패턴을 참고하여 dev1/dev2 프롬프트 토큰 절감 수행.

1. **미팅 진행**: 오딘(진행), 토르(백엔드), 미미르(UX/UI), 헤임달(테스터) 참석. 방안 A(외부 파일 참조) 만장일치 채택.
2. **DIRECT-WORKFLOW.md 생성**: 코워크 가이드, 워크플로우 8단계, 작업 규칙을 외부 파일로 분리. dev3의 GLM-WORKFLOW.md와 동일한 패턴.
3. **team_prompts.py 리팩토링**: `_build_direct_prompt()` 함수를 경량화. 인라인 보일러플레이트 제거 → 파일 참조 + 최소 변수 전달.
4. **테스트 업데이트**: 기존 11개 테스트 수정 + 3개 신규 테스트 추가 → 14개 전체 통과.

## 성과: 토큰 절감 결과

- dev1-team: 2,258자 → 536자 (**76.3% 절감**)
- dev2-team: 2,254자 → 532자 (**76.4% 절감**)
- dev3-team: 720자 → 720자 (변경 없음, 이미 최적화)
- **목표 50% 절감을 76%로 초과 달성**

## 생성/수정 파일 목록

| 파일 | 변경 유형 | 설명 |
|------|-----------|------|
| `prompts/team_prompts.py` | 수정 | `_build_direct_prompt()` 경량화 (GLM 패턴 적용) |
| `prompts/DIRECT-WORKFLOW.md` | 신규 | dev1/dev2 팀장 워크플로우 가이드 |
| `prompts/test_team_prompts.py` | 수정 | 테스트 업데이트 + 3개 신규 테스트 |
| `memory/meetings/2026-03-06-langsmith-token-efficiency.md` | 신규 | 미팅 기록 |
| `memory/specs/dispatch-token-optimization.md` | 신규 | 종합 스펙 문서 (전후 비교, 도입 근거) |

## 테스트 결과

- test_team_prompts.py: **14/14 PASS**
- test_consistency.py: **3/3 PASS** (dispatch/orchestrator 일치성)

## 셀프 QC

1. **영향 파일**: dispatch.py, orchestrator.py가 build_prompt() 호출 — 시그니처 변경 없어 영향 없음. test_consistency.py 검증 통과.
2. **엣지 케이스**: project_id=None, chain_id=None, 빈 task_desc — 모두 정상 처리.
3. **작업 지시 일치**: 미팅(방안 A 채택), 코드 리팩토링, 외부 파일 생성, 토큰 검증, 스펙 문서 — 모두 완료.
4. **에러/보안**: DIRECT-WORKFLOW.md는 읽기 전용 정적 파일. ANU_KEY 노출은 기존과 동일(내부 시스템).
5. **테스트 커버리지**: dev1/dev2/dev3 프롬프트, critical/security 레벨, 파일 존재, 크기, 변수 포함, 일치성 — 전 경로 커버.

## QC 자동 검증 결과

```json
{
  "task_id": "task-285.1",
  "overall": "PASS",
  "checks": {
    "api_health": "SKIP (서버 작업 아님)",
    "file_check": "PASS",
    "data_integrity": "PASS",
    "test_runner": "SKIP (별도 test dir 없음)",
    "schema_contract": "SKIP (workers 변경 없음)"
  }
}
```

## 버그 유무

없음.

## 비고

- LangSmith evaluator 패턴의 QC/마아트 프로세스 통합은 향후 별도 작업으로 추진 권장
- 기각된 방안 B(작업 유형별 템플릿), C(CLAUDE.md 탑재)의 사유는 미팅 기록 및 스펙 문서에 기록