claude-cli-analytics 0.0.5 → 0.0.6

package/README.md

@@ -129,10 +129,9 @@ CLAUDE_PROJECTS_DIR=/path/to/claude/projects claude-cli-analytics
 |------|----------|------|------|
 | **캐시 히트율** | `cache_read / (input + cache_read) × 100` | ≥ 70% | 스킬(컨텍스트)이 자동으로 로드된 비율 |
 | **스펙 컨텍스트 활용률** | `spec 파일 읽은 세션 / 전체 세션 × 100` | ≥ 90% | `.claude/` 스펙이 자동 트리거된 비율 |
-| **위험 레벨** | `<20K: 최적, 20-50K: 주의, >50K: 위험` | 최적 | 컨텍스트 과부하 경고 |
-| **리미트 영향도** | `(총 컨텍스트 / 44,000) × 100%` | — | Claude Pro 5시간 한도 대비 사용량 |
+| **위험 레벨** | 모델별 비용 가중 `avgContext × costMultiplier` | 최적 | 컨텍스트 과부하 경고 (모델별 기준 상이) |
 
-**측정 방법**: 테스트 쿼리 10~20개를 실행하여, 자동으로 캐시 히트가 되는 비율과 스펙 컨텍스트가 로드되는 비율을 추적합니다.
+**측정 방법**: 세션별 캐시 히트 비율과 스펙 컨텍스트 로드 비율을 자동 추적합니다.
 
 #### 2. 도구 호출 효율성 (Tool Call Efficiency)
 
@@ -163,29 +162,29 @@ CLAUDE_PROJECTS_DIR=/path/to/claude/projects claude-cli-analytics
 
 ### 🎯 정성적 지표 (Qualitative Metrics)
 
-#### 4. 사용자 개입 빈도 (User Intervention Frequency)
+#### 4. 사용자 개입 효율 (User Intervention Efficiency)
 
-> *Anthropic 기준: 사용자가 Claude에게 다음 단계를 묻지 않아도 됨*
+> *Anthropic 기준: 숙련된 사용자는 "능동적 모니터링" 전략을 취하므로, 단순 개입 횟수보다 **편집 대비 개입 비율**(HT/E)이 중요함*
 
 | 지표 | 계산 방식 | 목표 | 의미 |
 |------|----------|------|------|
-| **Human Turns** | 사용자 메시지(명령 포함) 횟수 | 최소화 | 사용자가 방향 전환/명확화한 횟수 |
-| **Auto Turns** | 자동 실행된 턴 수 | 최대화 | 사용자 개입 없이 진행된 턴 수 |
-| **HT/Edit 비율** | `Human Turns / Edit 횟수` | < 1.0 | 수정당 사용자 개입 빈도 |
+| **HT/E** | `Human Turns / Edit 횟수` | < 1.0 | 코드 수정 1회당 인간 감독의 "세금" |
+| **HT/E 개선율** | `(1 - HTE_spec / HTE_nospec) × 100` | 양수 | Spec 도입으로 인한 감독 감소 효과 |
+| **자율 실행률** | `Auto Turns / (Auto + Human) × 100` | ≥ 60% | 사용자 개입 없이 진행된 비율 |
 
-**측정 방법**: 테스트 중 사용자가 방향을 전환하거나 명확히 설명해야 하는 빈도를 기록합니다.
+**측정 방법**: Spec 유무별 HT/E를 자동 계산하여, Spec 도입이 인간 감독 부담을 실제로 줄이는지 정량화합니다.
 
 #### 5. 워크플로우 자립 완료율 (Workflow Autonomy)
 
-> *Anthropic 기준: 사용자 수정 없이 완료되는 워크플로우*
+> *Anthropic 기준: SEI(Spec Efficiency Index)와 P99 자율 실행 시간이 에이전트의 자율성 한계를 보여주는 핵심 지표*
 
 | 지표 | 계산 방식 | 목표 | 의미 |
 |------|----------|------|------|
-| **반복 수정율** | `(전체수정 - 고유파일) / 전체수정 × 100` | < 20% | 재작업 없이 완료된 비율 |
-| **효율성 점수** | 캐시·오류·작업 효율 종합 (100점) | ≥ 80 | 워크플로우 자립 완성도 |
-| **SEI** | `(Accuracy × 100) / log₁₀(Spec Volume + 1)` | — | 스펙 문서의 실효성 |
+| **SEI** | `(Accuracy × 100) / log₁₀(CacheRead + 1)` | ≥ 25 (Elite) | Spec 문서의 실효성 지수 |
+| **P99 자율 실행 시간** | 세션 시간의 99th percentile (분) | 증가 추세 | 에이전트에게 맡기는 최장 자율 실행 시간 |
+| **효율성 점수** | 캐시·오류·작업 효율·비용 종합 (100점) | ≥ 80 | 워크플로우 자립 완성도 |
 
-**측정 방법**: 동일 요청을 3~5회 실행하여 구조적 일관성과 품질 측면에서 출력을 비교합니다.
+**측정 방법**: Spec 유무별 SEI와 P99 자율 실행 시간을 비교하여, Spec이 에이전트의 자율적 작업 능력을 얼마나 향상시키는지 추적합니다. 평균 세션 시간 대신 99th percentile tail-end를 추적하는 것이 Anthropic의 권장 방법입니다.
 
 #### 6. 세션 간 일관성 (Cross-Session Consistency)
 
@@ -195,7 +194,7 @@ CLAUDE_PROJECTS_DIR=/path/to/claude/projects claude-cli-analytics
 |------|----------|------|------|
 | **Engineering Grade** | Efficiency(40%) + Stability(30%) + Precision(30%) - Penalty | S급 | 세션별 품질 등급 일관성 |
 | **등급 분포** | S/A/B/C 세션 비율 | S·A ≥ 80% | 전체 세션의 품질 편차 |
-| **스펙 유무 비교** | 스펙 있는 세션 vs 없는 세션 성과 차이 | — | 컨텍스트 효과의 일관성 |
+| **Spec 자율성 효과** | Spec 유무별 HT/E · SEI · P99 비교 | — | Spec 도입 효과의 정량적 입증 |
 
 **측정 방법**: 신규 사용자가 최소한의 안내만으로 첫 시도에서 작업을 완료할 수 있는지 평가합니다.