# task: 스킬 사용 추적 시스템 & 대시보드 연동

## 작업 레벨: Lv.4 (대규모 프로젝트)
- 3문서(계획서/맥락노트/체크리스트) + 에이전트 미팅(DA 필수) + 핵미사일 발사코드
- **한정승인**: 팀장이 전체 Phase를 자율 진행

## 배경
- 현재 아누 시스템에 87개+ 스킬이 등록되어 있으나, **사용 추적 시스템이 전무**
- 어제(3/26) 기준 JSONL 세션 로그 수동 분석 결과: Skill 도구 호출은 3개 스킬/12회뿐
- 제이회장님 지시: 스킬 사용 현황을 실시간으로 파악 가능한 시스템 필요

## 핵심 요구사항

### 1. 스킬 사용 로거 (Skill Usage Logger)
- 모든 Skill 도구 호출 시 자동으로 사용 기록 저장
- 기록 항목: 스킬명, 호출 시각, 호출 세션(봇/팀), 입력 요약, 소요시간
- 저장소: `skill-usage.jsonl` 또는 적절한 포맷 (실시간 카운팅 가능해야 함)
- **구현 방식 분석 필수**: 현재 스킬 호출 경로를 추적하여 어디에 훅을 걸 수 있는지 파악
  - Claude Code Skill 도구 호출 시점
  - dispatch.py를 통한 팀 위임 시 스킬 사용
  - 직접 스킬 참조 (CLAUDE.md 기반)

### 2. 대시보드 연동 (Dashboard Integration)
- 대시보드 위치: `http://100.76.130.39:8000/dashboard/`
- 대시보드 소스: `/home/jay/workspace/dashboard/`

#### 2-1. 스킬 목록 표시
- 아누 시스템에 학습된 **전체 스킬 목록** 표시
- 스킬 디렉토리: `/home/jay/workspace/skills/`
- 각 스킬의 설명, 카테고리, 상태(활성/비활성/deprecated) 표시

#### 2-2. 배치상황 동적 연동
- 현재 어떤 팀이 어떤 스킬을 사용 중인지 실시간 반영
- task-timers.json과 연동하여 진행 중 작업에서 사용되는 스킬 표시

#### 2-3. 호출 횟수 실시간 카운팅
- **조회 단위**: 일 / 주 / 월 / 분기 (디폴트: 일)
- 스킬별 호출 횟수, 총 호출 횟수, 트렌드 차트
- 필터링: 기간별, 팀별, 스킬 카테고리별

### 3. 기존 스킬 문서화/코드화 분석 (필수 선행)
- 스킬이 이미 문서화 또는 코드로 구현된 것이 있을 수 있음
- 분석 대상:
  - `/home/jay/workspace/skills/` 하위 전체 스킬 구조
  - `/home/jay/workspace/utils/skill_loader.py` (있다면)
  - `/home/jay/workspace/memory/skill-router.py` (있다면)
  - 각 팀 CLAUDE.md에서 스킬 참조 방식
  - autoresearch 모듈의 skill_executor.py — 스킬 로드/실행 패턴
- **이미 사용 추적 로직이 일부 구현되어 있을 수 있으니 반드시 확인 후 설계**

## Lv.4 프로세스 (팀장 자율 진행)

### Phase 1: 리서치 & 분석
- 기존 스킬 시스템 전수 분석 (코드, 문서, 호출 경로)
- 대시보드 현재 구조 파악
- 스킬 사용 추적 가능한 훅 포인트 식별

### Phase 2: 에이전트 미팅 + 3문서
- 에이전트 미팅 소집 (DA=로키 필수 참석)
- 3문서 작성: 계획서 / 맥락노트 / 체크리스트
- "3 Whys" 품질 검증 적용
- 미팅 반복 → 개선점 없을 때 최종 확정

### Phase 3+: 구현
- 3문서 기반 구현
- 단위 테스트 + 통합 테스트
- 대시보드 배포

## 참고 파일
- 대시보드 소스: `/home/jay/workspace/dashboard/`
- 스킬 디렉토리: `/home/jay/workspace/skills/`
- 조직도: `/home/jay/workspace/memory/organization-structure.json`
- task-timers: `/home/jay/workspace/memory/task-timers.json`
- autoresearch: `/home/jay/workspace/scripts/autoresearch/`
- 아누 가이드: `/home/jay/workspace/memory/specs/anu-guide.md`

## 제외 사항
- 사용 0회 스킬 정리/폐기 검토 — 제외 (제이회장님 별도 지시 시 진행)