metrics-designlisted
Install: claude install-skill kimsanguine/hplan
# metrics-design
> AI 에이전트의 메트릭 계층 설계 — North Star 정의 후 KPI 파생
## Core Goal
- **단일 North Star 메트릭으로 팀 전략 정렬** — 운영 건강도와 비즈니스 임팩트를 동시에 반영하는 "하나의 숫자" 확립
- **North Star를 KPI 대시보드의 최상위에 연결** — Leading/Lagging 지표 계층을 결정론적 공식으로 정의
- **의사결정 우선순위 명확화** — 충돌하는 지표 간 트레이드오프를 North Star 기준으로 일관성 있게 해결
---
## Trigger Gate
### Use This Skill When
- "북극성 메트릭 정의해줘" — North Star가 필요한 모든 상황
- "KPI 설정해줘" — 에이전트 성과 지표 체계 구축 시
- "에이전트 성과 측정 기준 잡아줘" — 메트릭 계층 전체가 필요할 때
- 새로운 에이전트 제품 론칭, 기존 KPI 충돌, 분기 OKR 연결 시
### Route to Other Skills When
- **portfolio --mode report --view scorecard** → 정의된 KPI로 상대 비교 점수화
- **ops-review --mode cost** → North Star에 비용 효율 요소가 포함될 때
- **이 스킬의 코호트 분석 기법** → North Star 추이를 코호트별로 추적할 때 (아래 "관련 기법 — 코호트 분석" 섹션)
- **reliability** → A/B 테스트의 Primary 메트릭으로 North Star 사용 시
### Boundary Checks
- **코드 배포해줘** → deliver 플러그인으로 라우팅
- **UI 점검해줘** → deliver/ui-validate로 라우팅
- 메트릭 선택의 주관성 → 5가지 기준(Actionable · Measurable · Understandable · Leading · Composite) 충족 여부 점검
- Anti-metric 설정 → North Star 최적화로 인한 다른 지표 악화를 사전에 차단
---
## 개념
North Star Metric은 에이전트의 성공을 하나의 숫자로 표현한다. KPI는 그 숫자를 분해한 운영 건강도(잘 돌아가는가)와 비즈니스 임팩트(가치를 만드는가)의 두 축이다. 두 층을 함께 설계하지 않으면 "정확도만 높고 쓸모없는" 또는 "가치있지만 불안정한" 에이전트가 된다.
---
## Instructions
You are designing metrics for: **$ARGUMENTS**
Parse `--step` from the arguments:
- `--step north-star` → Run Phase A only
- `--step kpi` → Run Phase B only
- `--step okr` → Run Phase C only (OKR 설계)
- `--step all` or no `--step` flag → Run Phase A then Phase B