From playbook-dev
This skill should be used when the user asks to "define clustering strategy", "create multi-axis clustering", "design cohort segmentation", "build clustering dimensions", "group items by multiple factors", or needs to design how items should be grouped across multiple dimensions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/playbook-dev:clustering-strategyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Define multi-axis clustering strategies for performance, failure mode, item type, and other dimensions.
Define multi-axis clustering strategies for performance, failure mode, item type, and other dimensions.
Single-dimension clustering misses important patterns. Multi-axis clustering reveals:
| Axis | Groups By | Example Clusters |
|---|---|---|
| Performance | Outcome quality | High / Medium / Low |
| Failure Mode | How things fail | Taxonomy tags |
| Item Type | Category | Type A / B / C |
| Pipeline Stage | Where failure occurs | Collection / Analysis / Synthesis |
| Gap Type | What's missing | Capability categories |
| Evolution | Change over time | Improved / Stable / Regressed |
| Severity | Impact level | Critical / High / Medium / Low |
Design axes relevant to your domain:
## Domain: {Name}
### Axis: {Custom Dimension}
**Groups by:** {What distinguishes clusters}
**Clusters:**
| Cluster | Criteria | Count |
|---------|----------|-------|
| {Name} | {Definition} | N |
| {Name} | {Definition} | N |
| {Name} | {Definition} | N |
**Why this axis matters:**
{How it informs action}
List all potentially useful clustering dimensions:
## Potential Clustering Axes
| Axis | Data Source | Actionable? |
|------|-------------|-------------|
| Performance | Scores in analysis | Yes |
| Failure mode | Classification tags | Yes |
| Item type | Item metadata | Yes |
| Complexity | Item characteristics | Maybe |
| {Other} | {Source} | {Yes/No} |
For each axis, specify clear boundaries:
## Axis: Performance
| Cluster | Criteria | Rationale |
|---------|----------|-----------|
| High | Score ≥80% | Reliable performance |
| Medium | Score 60-79% | Needs improvement |
| Low | Score <60% | Significant issues |
Plan how to analyze combinations:
## Cross-Cluster Analysis Plan
### Correlation: Performance × Failure Mode
**Question:** Do certain failure modes dominate low performers?
**Matrix:**
| Performance | Mode A | Mode B | Mode C |
|-------------|--------|--------|--------|
| High | ? | ? | ? |
| Medium | ? | ? | ? |
| Low | ? | ? | ? |
**Expected insight:** {What pattern might emerge}
Create actionable cohorts from cluster combinations:
## Cohort Segmentation
| Cohort | Profile | Treatment |
|--------|---------|-----------|
| Ready | High perf, minimal gaps | Deploy |
| Needs X | Medium perf, specific gap | Fix gap |
| Needs Y | Low perf, structural issue | Redesign |
# {Axis} Clusters
## Overview
| Cluster | Count | % | Key Characteristic |
|---------|-------|---|-------------------|
| {Name} | N | X% | {Brief} |
---
## Cluster: {Name}
### Membership
| ID | {Key Metric} | Notes |
|----|--------------|-------|
| {ID} | {Value} | {Note} |
### Common Characteristics
- {Pattern 1}
- {Pattern 2}
### Distinguishing Factors
What sets this cluster apart:
- {Factor 1}
- {Factor 2}
### Representative Example
**{ID}:** {Why representative}
### Treatment
{What to do with items in this cluster}
# Cross-Cluster Analysis
## {Axis A} × {Axis B}
### Correlation Matrix
| {Axis A} \ {Axis B} | {B1} | {B2} | {B3} |
|---------------------|------|------|------|
| {A1} | N | N | N |
| {A2} | N | N | N |
| {A3} | N | N | N |
### Pattern: {Description}
**Observation:** When {Axis A} = {value}, {Axis B} tends to be {pattern}.
**Frequency:** N of M items (X%)
**Implication:** {What this means for action}
### Exceptions
Items that don't fit the pattern:
- {ID}: {Why different}
---
## Multi-Axis Insights
### Insight 1: {Title}
**Pattern:** {Description}
**Evidence:**
- {Supporting data}
**Action:** {What to do}
### Insight 2: {Title}
...
---
## Cohort Segmentation
| Cohort | Multi-Axis Profile | Count | Treatment |
|--------|-------------------|-------|-----------|
| Ready | High perf, Type A | N | Deploy now |
| Needs capability | Low reach, Type B | N | Build capability |
| Needs redesign | Low perf, Mode X | N | Architecture change |
Priority = (Cluster Size × Improvement Potential) / (Effort × Risk)
## Priority by Cluster
| Cluster | Size | Improvement | Effort | Risk | Priority |
|---------|------|-------------|--------|------|----------|
| {Name} | N | +X | Low | Low | P1 |
| {Name} | N | +Y | Medium | Low | P2 |
| {Name} | N | +Z | High | Medium | P3 |
Start with performance clusters:
- High performers → Understand what works
- Low performers → Diagnose issues
Then overlay:
- Failure mode → Why they fail
- Gap type → What's missing
Start with failure mode clusters:
- Each failure mode → Different fix
Then overlay:
- Performance → Severity
- Item type → Fix applicability
Start with evolution clusters (vs baseline):
- Improved → What worked
- Regressed → What broke
- Stable → Baseline
Then overlay:
- Failure mode → What changed
- Change attribution → Why it changed
Before finalizing clusters:
For clustering strategies:
${CLAUDE_PLUGIN_ROOT}/references/playbook-pattern.md - Section 4.9npx claudepluginhub tgvashworth/agent-plugins --plugin playbook-devStructures problems, findings, or analysis into mutually exclusive, collectively exhaustive categories to ensure no gaps and no overlaps. Useful for strategy, consulting, and structured thinking.
Organizes qualitative research data from interviews, observations, or surveys into affinity diagrams with clusters, themes, insight statements, and prioritization.
Analyzes user cohorts for retention curves, feature adoption trends, churn patterns, and engagement insights. Generates heatmaps, charts, Python scripts, and research recommendations.