cogs-sentinellisted
Install: claude install-skill kimsanguine/hplan
# COGS Sentinel — Executable Margin Gate
Running for: **$ARGUMENTS**
## Core Goal
- Token 단가와 사용 패턴으로부터 **p50/p90 월간 COGS와 gross margin을 계산**하여 paid AI product의 경제적 viability를 *PRD 전에* 판단한다.
- Free-user abuse 시나리오를 blend해 "유료 1명당 무료 24명을 감당해야 할 때" 마진이 살아남는지 본다.
- 결정은 **GREEN / CONDITIONAL_GO / RED** + 구체적 mitigation 권고.
## Trigger Gate
### Use This Skill When
- 사용자가 유료 가격을 책정하려 할 때 (`$X/mo`, `per-call`, etc.)
- `discover/cost-sim`이 시나리오를 도출한 후 결정론적 수치가 필요할 때
- Provider 교체(Anthropic ↔ OpenAI ↔ Google)의 영향 측정
- 무료 tier 도입 시 abuse가 마진을 깨지 않는지 사전 검증
- Build Gate 진입 *전*
### Route to Other Skills When
- 비용 시나리오 자체가 아직 명확하지 않을 때 → `discover/cost-sim` 먼저
- 배포 후 실제 추적 → `operate/ops-review`
- 가격 모델 자체를 다시 짤 때 → `architect/strategy`
- COGS RED 결정이 났을 때 → `decision-log` (hold/pivot) 기록 후 routing
### Boundary Checks
- ℹ️ `--cac`와 `--monthly-churn`을 함께 전달하면 LTV/CAC/Payback + overall_verdict(BUILD/HOLD/INVESTIGATE)를 **추가로** 산출한다. 두 인자를 생략하면 무시되어 하위호환이 유지된다. (`--mau` 추가 시 Business Report 블록 — 매출/COGS/cost_ratio/blended — 도 포함됨.)
- ℹ️ 이 skill은 sanity-check(빌드 게이트)이지 회계 보고서가 아니다 — 법인세·감가상각 등 전산 회계 항목은 다루지 않는다.
- ❌ Provider 단가는 `references/provider_pricing.json` 스냅샷 기준이다. 최신 단가는 사용자가 verify해야 함.
- ❌ lognormal sampling이라 결정론적이지만 실제 분포와 다를 수 있다 — sanity check 용도지 회계 보고서 아님.
## Inputs
CLI:
```bash
python3 hplan/scripts/cogs_sentinel.py \
--provider anthropic --model claude-sonnet-4-6 \
--tokens-in 3000 --tokens-out 1500 --calls-per-user-month 40 \
--arpu 29 --paid-conversion 0.