# 토큰 사용량 최적화 에이전트 미팅

**일시**: 2026-03-27
**Task**: task-1123.1
**팀**: dev7-team
**퍼실리테이터**: 이참나
**참석자**: 쿠쿨칸, 이쉬첼, 아쿠인, 카마소츠

---

## 안건

### [토론 1] 대용량 파일 분할 전략

**이참나 (퍼실리테이터)**: 리서치 결과 14개 파일이 10,000토큰을 초과합니다. geo-optimizer/SKILL.md가 약 19,933토큰으로 가장 크고, frontend-design/SKILL.md가 17,936토큰입니다. 분할 전략을 논의하겠습니다.

**쿠쿨칸 (백엔드)**: 분할 자체에는 동의하지만, 방식이 중요합니다. geo-optimizer/SKILL.md의 하단 49%가 동적 운영 데이터라고 했는데, 이 부분을 별도 파일로 분리하면 에이전트가 어느 파일을 읽어야 할지 판단 로직이 복잡해집니다. 네이밍 컨벤션부터 합의해야 합니다.

**이쉬첼 (프론트엔드)**: frontend-design/SKILL.md의 Quick Reference 47% 분리는 적극 찬성입니다. SKILL-QUICKREF.md로 분리하면 가벼운 세션에서는 Quick Reference만 로드하면 됩니다. 다만 두 파일 간 내용 중복이 생기지 않도록 관리가 필요합니다.

**아쿠인 (UX/UI)**: 구조 설계 관점에서 보면, 단순히 파일을 자르는 것보다 정보 계층을 기준으로 분리해야 합니다. 제안: SKILL.md(핵심 기능 정의, 상시 로드) / SKILL-REF.md(참조용 상세 정보, 필요 시 로드) / SKILL-OPS.md(운영/동적 데이터, 특정 작업 시 로드).

**카마소츠 (테스터)**: 분할 후 검증 방법을 먼저 정해야 합니다. 각 분할 파일에 대해 "이 파일만으로 수행 가능한 작업 목록"을 명시하자고 제안합니다.

### [토론 2] 토큰 절약 방안 우선순위

**쿠쿨칸 (백엔드)**: 절약 효과 기준뿐 아니라 시스템 안정성 관점에서 위험도를 같이 봐야 합니다. team_prompts.py의 에이전트 미팅 규칙 중복 제거는 diff를 먼저 확인해야 합니다. publishing 팀원 소환 지시 통합이나 dev8 인라인 체크리스트 통합은 안전한 작업입니다.

**이쉬첼 (프론트엔드)**: DIRECT-WORKFLOW.md 분리를 1순위로 봅니다. 세션당 3,800토큰이 매 세션마다 발생하므로 누적 효과가 가장 큽니다. "세션 빈도 × 절약량" 기대값으로 우선순위를 정하자고 제안합니다.

**아쿠인 (UX/UI)**: whisper 유휴경고 섹션 조건부 출력도 주목합니다. 33토큰이라 숫자는 작지만, 불필요한 경고가 에이전트 집중도를 분산시킵니다. 토큰 절약 + 출력 품질 개선 두 가지 효과.

**카마소츠 (테스터)**: 디자인 금지 경고 축약(~47토큰)에 이의를 제기합니다. 금지 사항은 명확하고 강하게 표현될수록 준수율이 높습니다. 47토큰을 아끼려다 위반이 생기면 더 큰 비용입니다.

### [토론 3] Quick-win 즉시 실행 범위

**쿠쿨칸 (백엔드)**: publishing 팀원 소환 지시 통합과 dev8 인라인 체크리스트 통합은 지금 바로 할 수 있습니다. team_prompts.py 중복 제거는 diff 확인 없이는 하면 안 됩니다.

**이쉬첼 (프론트엔드)**: DIRECT-WORKFLOW.md 분리도 Quick-win으로 가능합니다. 원본 유지 + 분리본 추가 방식이면 위험 없습니다.

**아쿠인 (UX/UI)**: whisper 조건부 출력도 조건 정의가 단순하면 오늘 가능합니다.

**카마소츠 (테스터)**: Quick-win 실행 전 현재 토큰 사용량 베이스라인 측정이 먼저 필요합니다. 실행 전후 비교 테스트가 있어야 합니다.

---

## 합의 사항

- **결정 1**: 대용량 파일 분할은 실행 전 네이밍 컨벤션 문서와 분할 파일별 적용 범위 명세를 선행 작성한다. (정보 계층 3단계: SKILL.md / SKILL-REF.md / SKILL-OPS.md)
- **결정 2**: 토큰 절약 우선순위는 "세션 빈도 × 절약량" 기대값 기준. 순서: DIRECT-WORKFLOW.md 분리 → 대용량 파일 분할 → team_prompts.py 중복 제거(diff 확인 후) → 소규모 항목.
- **결정 3**: team_prompts.py 중복 제거는 3팀 규칙 diff 확인을 먼저 수행하고 실제 동일 여부 확인 후 진행.
- **결정 4**: 디자인 금지 경고 축약(~47토큰)은 별도 검토 항목으로 분류. 내용 검토 없이 축약하지 않음.
- **결정 5 (Quick-win 즉시 실행)**: 다음 3개 항목을 즉시 실행한다.
  - publishing 팀원 소환 지시 통합 (~83토큰)
  - dev8 인라인 체크리스트 → QC-RULES.md 통합 (~150토큰)
  - DIRECT-WORKFLOW.md 분리본 생성 (원본 유지, 세션당 ~3,800토큰 절약 목표)
- **결정 6**: whisper 유휴경고 조건부 출력은 오늘 중 조건 정의 가능 여부 확인 후 Quick-win 포함 여부 결정.

## 미해결 사항

- team_prompts.py 3팀 규칙 diff: 실제로 동일한지 확인 필요
- 분할 파일 네이밍 컨벤션 문서: 작성 담당자 및 완료 일정 미정
- whisper 조건부 출력 조건 정의: 오늘 중 판단 보류
- hermes 설계서 요약본 분리: 요약 품질 기준 미정. 별도 논의 필요