solo-metrics-track

/metrics-track

Set up a metrics tracking plan for a project. Defines PostHog event funnel, KPI benchmarks, and kill/iterate/scale decision thresholds based on lean startup principles.

MCP Tools (use if available)

• kb_search(query) — find PostHog methodology, analytics patterns

If MCP tools are not available, fall back to Grep + Read.

Methodology Reference

This skill implements metrics tracking based on lean startup principles:

• Relative metrics vs niche benchmarks — compare against your own trajectory, not vanity averages
• Kill/iterate/scale decision rules — data-driven thresholds for product decisions (see step 7 below)

Steps

1. Parse project from $ARGUMENTS.

   • Read PRD for features, ICP, monetization model.
   • Read CLAUDE.md for stack (iOS/Web/both).
   • If empty: ask via AskUserQuestion.

2. Detect platform:

   • iOS app → PostHog iOS SDK events
   • Web app → PostHog JS SDK events
   • Both → cross-platform identity (shared user ID across platforms)

3. Load PostHog methodology:

   • If MCP available: kb_search("PostHog analytics events funnel identity")
   • Otherwise: check project docs for existing analytics configuration
   • Extract: event naming conventions, identity resolution, funnel pattern

4. Define event funnel based on PRD features:

   Standard funnel: Awareness → Acquisition → Activation → Revenue → Retention → Referral

   See references/kpi-benchmarks.md for the full event table, KPI thresholds, PostHog code snippets, and A/B test template. Adapt events to the specific product.

5. Forced reasoning — metrics selection: Before defining KPIs, write out:

   • North Star Metric: The ONE number that matters most (e.g., "weekly active users who completed core action")
   • Leading indicators: What predicts the North Star? (e.g., "activation rate D1")
   • Lagging indicators: What confirms success? (e.g., "MRR", "retention D30")
   • Vanity metrics to AVOID: (e.g., total downloads without activation)