Kpi Tree BuilderSAFE

An agent skill published by revfactory.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: kpi-tree-builder
description: "KPI 트리(지표 계층 구조)를 체계적으로 설계하고 드릴다운 구조를 정의하는 방법론. 'KPI 트리 만들어줘', '지표 계층 설계', '드릴다운 구조', 'KPI 분해', '성과 지표 체계', '매출 분해 트리' 등 KPI 체계 설계 시 사용한다. 단, 실제 데이터베이스 쿼리 최적화, 실시간 모니터링 인프라 구축은 이 스킬의 범위가 아니다."
---

# KPI Tree Builder — KPI 트리 설계 방법론

kpi-designer와 dashboard-builder의 지표 설계를 강화하는 스킬.

## 대상 에이전트

- **kpi-designer** — KPI 계층 구조를 체계적으로 설계한다
- **dashboard-builder** — 드릴다운 네비게이션을 구현한다

## KPI 트리 분해 방법론

### 수학적 분해 (Multiplicative)

```
매출 = 주문건수 × 객단가
     = (방문자수 × 전환율) × (상품단가 × 주문당 상품수)

방문자수 = 자연유입 + 유료유입 + 직접유입
전환율 = 장바구니전환 × 결제전환
```

### 가산적 분해 (Additive)

```
총비용 = 인건비 + 마케팅비 + 서버비 + 기타운영비
총매출 = 제품A매출 + 제품B매출 + 서비스매출
```

### 비율 분해 (Ratio)

```
고객생애가치(LTV) = ARPU × 평균 이용 기간
CAC 회수기간 = CAC / 월 ARPU
ROI = (이익 - 투자) / 투자 × 100
```

## 도메인별 KPI 트리 템플릿

### 이커머스

```
매출 (Revenue)
├── GMV (총 거래액)
│   ├── 주문건수
│   │   ├── 방문자수 (UV)
│   │   │   ├── 오가닉 트래픽
│   │   │   ├── 유료 트래픽 (CPC, CPA)
│   │   │   └── 리퍼럴 트래픽
│   │   └── 구매전환율 (CVR)
│   │       ├── 장바구니 전환율
│   │       └── 결제 완료율
│   └── 객단가 (AOV)
│       ├── 상품 단가
│       └── 주문당 상품 수
├── 수수료율
└── 취소/반품률
```

### SaaS

```
ARR (연간반복매출)
├── 신규 ARR
│   ├── 신규 고객 수
│   │   ├── 리드 수
│   │   ├── 리드→트라이얼 전환율
│   │   └── 트라이얼→유료 전환율
│   └── 신규 ARPA (고객당 매출)
├── 확장 ARR (업셀/크로스셀)
│   ├── 확장 고객 비율
│   └── 확장 금액
├── 이탈 ARR (-)
│   ├── 이탈 고객 수
│   └── 이탈 ARPA
└── NRR (순 매출 유지율)
    = (시작 ARR + 확장 - 축소 - 이탈) / 시작 ARR
```

### 마케팅

```
ROAS (광고 수익률)
├── 광고 매출
│   ├── 클릭수
│   │   ├── 노출수 (Impressions)
│   │   └── CTR (클릭률)
│   └── 클릭당 전환 가치
│       ├── 전환율
│       └── 전환당 가치
└── 광고 비용
    ├── CPC × 클릭수
    └── CPM × 노출수/1000
```

## KPI 정의서 표준 양식

```markdown
### KPI: [지표명]

| 항목 | 내용 |
|------|------|
| 정의 | [지표의 명확한 정의] |
| 공식 | [계산 수식] |
| 단위 | [%, 원, 건, 명 등] |
| 측정 주기 | [일/주/월/분기] |
| 데이터 소스 | [테이블명 또는 API] |
| 목표 | [목표치 + 근거] |
| 임계값 | [경고: 80%, 위험: 60%] |
| 책임자 | [담당 팀/개인] |
| 드릴다운 | [하위 지표 목록] |
| 필터 | [기간, 지역, 상품 등] |
```

## 지표 품질 체크리스트 (SMART-D)

```
S - Specific: 명확하게 정의되어 있는가?
M - Measurable: 정량적으로 측정 가능한가?
A - Actionable: 이 지표로 의사결정이 가능한가?
R - Relevant: 비즈니스 목표와 연결되는가?
T - Timely: 적절한 주기로 갱신되는가?
D - Drillable: 원인 분석을 위해 분해 가능한가?
```

## 임계값 설정 방법

```
방법 1: 통계 기반
  - 평균 ± 1σ: 경고
  - 평균 ± 2σ: 위험
  - 과거 12개월 데이터 기준

방법 2: 벤치마크 기반
  - 산업 평균 대비 80%: 경고
  - 산업 평균 대비 60%: 위험

방법 3: 목표 기반
  - 목표 대비 80% 미달: 경고
  - 목표 대비 60% 미달: 위험

방법 4: 추세 기반
  - 전주 대비 -10%: 경고
  - 전주 대비 -20%: 위험
```

## 드릴다운 설계 패턴

```
Level 0: 경영 요약 (Executive Summary)
  → 핵심 KPI 3-5개, 트렌드, 이상치 알림

Level 1: 부서별 대시보드
  → 마케팅/세일즈/운영/CS별 핵심 지표

Level 2: 상세 분석
  → 시계열, 세그먼트별 비교, 코호트

Level 3: 원시 데이터
  → 개별 트랜잭션, 필터링, 내보내기
```

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.