Analyze Metrics

Overview

Review product metrics against targets, identify trends across cohorts, distinguish leading from lagging indicators, and generate hypotheses for unexpected changes. Turns raw numbers into actionable insight.

Workflow

1. Read metrics context — Scan .chalk/docs/product/ for any metrics framework, KPI definitions, or previous metrics reviews. Identify which metrics have defined targets and baselines.

2. Gather metrics data — Parse $ARGUMENTS for the specific metrics or period to analyze. If the user provides data inline or references a file, read it. If no data is provided, ask the user to supply current metric values.

3. Classify each metric — For each metric, determine:

   • Type: leading (predictive) vs. lagging (outcome)
   • Category: acquisition, activation, engagement, retention, revenue, referral
   • Comparison basis: target value, previous period, cohort benchmark

4. Assess current vs. target — Compare each metric's current value against its target. Classify as: on-track (within 10%), at-risk (10-25% off), or off-track (>25% off). If no target exists, note the gap.