/segment-customers

name: segment-customers
description: Generates customer segmentation models, scoring logic, and activation briefs.
usage: /customer-analytics:segment-customers --goal "upsell" --inputs usage,firmographic --method hybrid --segments 5

Command: segment-customers

Inputs

• **goal** – business goal (upsell, retention, adoption, marketing efficiency).
• **inputs** – comma-separated data sources (usage, firmographic, revenue, support, survey).
• **method** – rules | clustering | hybrid.
• **segments** – target number of segments/personas to output.
• **activation** – optional channel focus (sales, cs, marketing, product).

Workflow

1. **Data Profiling** – evaluate selected inputs, quality, and coverage. 2. **Segmentation Design** – run clustering/heuristics, score stability, and interpretability. 3. **Scoring Logic** – define rules/weights for RevOps/data teams to implement. 4. **Persona Packaging** – craft segment personas with value props, risks, and KPIs. 5. **Activation Plan** – map segments to GTM plays, reporting, and refresh cadence.

Outputs

• Segmentation matrix (definition, criteria, size, key metrics).
• Scoring workbook/API spec with weights and thresholds.
• Activation brief aligning segments to plays/channels.

Agent/Skill Invocations

• `segmentation-architect` – leads modeling + documentation.
• `retention-analyst` – supplies usage/retention signals.
• `customer-insights-partner` – injects qualitative proof.
• `segmentation-framework` skill – provides templates + guardrails.
• `activation-map` skill – links segments to GTM workflows.

---