← ClaudeAtlas

cogs-sentinellisted

Executable COGS gate for AI products. Runs a deterministic Python sampler (lognormal token-cost distribution) to compute p50/p90 per-paid-user monthly COGS, gross margin scenarios, and free-user abuse blend. Returns GREEN / CONDITIONAL_GO / RED before any paid AI product is greenlit. Use when promising a paid AI feature, comparing providers (Anthropic/OpenAI/Google), or when discover/cost-sim has produced a usage hypothesis and you need real numbers.
kimsanguine/hplan · ★ 2 · AI & Automation · score 72
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.