---
name: monitor-retention
description: Builds retention dashboards, signal briefs, and recommended save plays per cohort.
usage: /customer-analytics:monitor-retention --window quarter --grouping "plan,persona" --include-expansion true
---

# Command: monitor-retention

## Inputs
- **window** – analysis window (month, quarter, rolling-90d).
- **grouping** – comma-separated dimensions (plan, persona, region, product, acquisition-channel).
- **include-expansion** – true/false to show upsell impact alongside churn.
- **signals** – optional list of metrics to emphasize (usage, support, sentiment, billing).
- **format** – dashboard | deck | brief.

## Workflow
1. **Data Refresh** – query billing, product telemetry, support, survey, and pipeline sources.
2. **Cohort Calculations** – compute retention, churn, expansion, and health indexes per grouping.
3. **Signal Detection** – surface top risk/improvement cohorts with quantified impact.
4. **Play Recommendations** – map cohorts to lifecycle or CS save plays with owners.
5. **Packaging** – produce dashboards/decks plus action trackers for leadership reviews.

## Outputs
- Retention dashboard with drillable cohorts.
- Signal brief highlighting risks/opportunities + recommended plays.
- Action tracker with owners, due dates, and success metrics.

## Agent/Skill Invocations
- `retention-analyst` – leads analytics + insights.
- `segmentation-architect` – ensures segment definitions align.
- `customer-insights-partner` – adds qualitative proof.
- `retention-dashboard` skill – provides visualization templates.
- `save-play-library` skill – links insights to remediation programs.

---