# Agent 미팅: LangSmith Progressive Disclosure 패턴 도입 → 토큰 효율화

**날짜**: 2026-03-06
**소집 이유**: dev1/dev2 프롬프트 보일러플레이트(~1,700자)가 매 위임마다 반복되어 토큰 낭비. LangSmith CLI Skills의 Progressive Disclosure 패턴을 참고하여 50% 절감 목표.
**참여 페르소나**: 오딘(2팀장, 진행), 토르(백엔드), 미미르(UX/UI), 헤임달(테스터)
**총 사이클 수**: 1

---

## Cycle 1

### 오딘 분석

현재 상태 측정 (코드 기반 근거):
- `team_prompts.py:_build_direct_prompt()` 생성 프롬프트: **2,254자 (~563토큰)**
- `team_prompts.py:_build_glm_prompt()` 생성 프롬프트: **720자 (~180토큰)** — 이미 GLM-WORKFLOW.md 참조로 경량화
- 보일러플레이트 분석:
  - `_build_cowork_section()`: ~400자 (매번 동일 구조, 팀원 이름만 다름)
  - 워크플로우 7단계: ~800자 (timer start/end, .done 파일, 아누 통보 — 매번 동일)
  - 작업 규칙: ~300자 (격리 규칙, 보고서 요구사항 — 매번 동일)
  - QC 검증: ~200자 (이미 QC-RULES.md 파일 참조로 경량화 완료)
- dev3 성공 사례: GLM-WORKFLOW.md에 워크플로우 전체를 외부화하고, 프롬프트에는 5개 변수(task_id, team_id, WORKSPACE_ROOT, CHAT_ID, ANU_KEY)만 전달

검토 방안:
- 방안 A: 보일러플레이트를 DIRECT-WORKFLOW.md로 분리, 프롬프트에 파일 경로 + 최소 변수만 전달
- 방안 B: 작업 유형별 템플릿 분리
- 방안 C: 팀장 CLAUDE.md에 공통 규칙 사전 탑재

### 페르소나 의견

**토르 (백엔드/구현 관점)**:
- **방안 A 추천**. 구현 난이도 최저 — dev3 GLM-WORKFLOW.md 패턴을 그대로 복제하면 됨
- 정적 읽기 전용 파일이므로 동시성 문제 없음 (race condition 불가)
- 변수 전달은 프롬프트에 `task_id=X, team_id=Y` 형태로 인라인, 파일은 템플릿 역할
- 테스트 호환성: 외부 파일 존재 assertion 1줄 추가로 해결

**미미르 (UX/구조 관점)**:
- **방안 A 권장**. 방안 C(CLAUDE.md)는 매 호출마다 로드되는 "누적 비용" — 토큰 절감이 아닌 단순 이동
- 방안 A는 동적 로딩으로 실질적 절감
- 프롬프트에 남길 최소 정보: 파일 경로 + 작업 컨텍스트(task_id, team_id, level) + 예외 플래그
- LangSmith 패턴 중 Evaluator 패턴이 우선 도입 대상 (팀 간 품질 편차 측정)

**헤임달 (테스터/검증 관점)**:
- 기존 테스트 중 문자열 직접 포함 검증(timer 명령, report_path 등)은 깨질 수 있음 — 업데이트 필요
- 필수 신규 테스트: 외부 파일 로딩 성공/실패, 변수 치환 검증, 필수 토큰 포함 확인
- 단순 길이 비교뿐 아니라 **필수 정보 완성도 점수**도 추적 권장
- 보안 주의: 외부 파일 경로 검증, 인젝션 방지

### 합의/결론

1. **방안 A 채택**: DIRECT-WORKFLOW.md 생성, dev3 GLM-WORKFLOW.md 패턴 적용
2. 프롬프트에는 최소 변수(task_id, team_id, WORKSPACE_ROOT, CHAT_ID, ANU_KEY, project_id, chain_id)만 전달
3. 코워크 섹션, 워크플로우 단계, 작업 규칙을 모두 DIRECT-WORKFLOW.md로 이동
4. 기존 테스트 업데이트 + 외부 파일 존재 확인 + 전후 길이 비교 테스트 추가
5. LangSmith trace/dataset/evaluator 중 evaluator 패턴은 향후 과제로 기록 (이번 작업 범위 외)

### 미해결 항목
- LangSmith evaluator 패턴의 QC/마아트 프로세스 통합 — 별도 작업으로 분리 필요

---

## 최종 합의 사항

1. **DIRECT-WORKFLOW.md** 생성 → 코워크/워크플로우/작업규칙 보일러플레이트 이동
2. **team_prompts.py** `_build_direct_prompt()` 리팩토링 → GLM 패턴 적용 (파일 참조 + 최소 변수)
3. **test_team_prompts.py** 업데이트 → 새 구조에 맞는 테스트 + 길이 비교 테스트
4. **목표**: 2,254자 → 1,500자 이하 (33% 이상 절감)
5. **evaluator 패턴 도입**: 이번 작업 범위 외, 향후 별도 작업으로 추진

## 다음 단계

- 합의 사항 1~3을 즉시 구현
- 구현 완료 후 전후 비교 문서 작성: `memory/specs/dispatch-token-optimization.md`
- 보고서 작성: `memory/reports/task-285.1.md`