KPI Library

Structured, queryable catalog of 52 KPI definitions across 9 business domains. Includes formula evaluation, benchmarks, validation, and a CLI.

Domains

• Marketing (7 KPIs) — CAC, CLV, CTR, conversion, email, ROAS, CPL
• Product (6) — DAU, MAU, NPS, activation, adoption, session duration
• Finance (6) — burn rate, margins, OpEx, revenue growth, runway
• Engineering (6) — DORA metrics, bug escape rate, test coverage
• Sales (5) — win rate, deal size, pipeline velocity, quota, cycle length
• Support (5) — CSAT, FCR, response time, resolution, volume
• SaaS (6) — MRR, ARR, churn, NRR, ARPU, LTV:CAC
• E-Commerce (5) — AOV, cart abandonment, repeat rate, inventory, returns
• Gaming (6) — ARPDAU, DAU/MAU, retention (D1/D7/D30), session length

CLI Usage

kpi list                          # List all KPIs
kpi list --domain engineering     # Filter by domain
kpi show churn_rate               # Full KPI definition (JSON)
kpi calc gross_margin revenue=100000 cogs=40000
kpi domains                       # List domain taxonomy
kpi validate my-kpi.json          # Validate a custom KPI
kpi add my-kpi.json               # Add to user catalog
kpi stats                         # Catalog statistics

As a Library

from src.kpi import KPICatalog

catalog = KPICatalog.from_directory(Path("src/kpi/builtin"))
for kpi in catalog.search(domain="saas"):
    print(f"{kpi.slug}: {kpi.name}")

License

MIT