# 맥락노트: 스킬 사용 추적 시스템

## 왜 이 작업이 필요한가?
- 87개+ 스킬이 등록되어 있으나 사용 추적이 전무
- 어제 JSONL 로그 수동 분석: 3개 스킬/12회 호출만 확인됨
- 제이회장님: 실시간 파악 가능한 시스템 필요

## 기존 코드 활용
- `utils/skill_loader.py` → list_skills() 함수로 모든 스킬 메타데이터 로드 가능
- `utils/skill_parser.py` → SKILL.md frontmatter 파싱 (name, description, triggers, category)
- `dashboard/server.py` → DataLoader 클래스에 메서드 추가
- `dashboard/components/App.js` → tabs 배열에 스킬 탭 추가

## 훅 포인트 분석 결과
- Claude Code Skill 도구 호출: 직접 캡처 불가 (Claude Code 내부)
- dispatch.py: 태스크 할당 시 스킬 injection은 추적 가능하나, 실제 Skill 호출과 다름
- 현실적 방안: REST API 기반 수동 로깅 + 레지스트리 자동 동기화

## 기술 결정
- 저장 포맷: JSONL (append-only, 파싱 쉬움, 기존 로그 패턴과 일치)
- 집계: 서버 사이드 (Python에서 JSONL 읽고 집계 후 JSON 응답)
- 카테고리: frontmatter category 필드 사용 + 미분류는 'general'