5.5 KiB
5.5 KiB
description: Re-rank insights from previous analysis with different criteria
argument-hint: [analysis-file] [--criteria]
Re-Rank Insights
Re-rank insights from a previous analysis using different criteria (frequency, impact, relevance, or custom).
Step 1: Load Previous Analysis
Read the analysis file ($1):
- Parse all themes/insights from the file
- Extract frequency data
- Note any existing rankings
Report to user:
## 📊 Analysis Loaded
**File:** $1
**Themes found:** [number]
**Current ranking:** [Current criteria if specified]
**Available themes:**
1. [Theme name] - Currently ranked #1
2. [Theme name] - Currently ranked #2
[etc.]
How would you like to re-rank these insights?
Step 2: Select Ranking Criteria
Present options to user:
## 🎯 Ranking Criteria Options
Choose how to rank insights:
1. **Frequency** - Most mentioned themes first
- Best for: Understanding what came up most often
- Data available: ✅
2. **Impact** - Highest impact/severity first
- Best for: Prioritizing what to act on
- Requires: Manual input or impact assessment
3. **Relevance to ICP** - Best fit with ideal customer profile
- Best for: Focusing on target audience needs
- Requires: ICP document for comparison
4. **Business Value** - Revenue/strategic opportunity size
- Best for: ROI-focused prioritization
- Requires: Business context assessment
5. **Ease of Implementation** - Quick wins first
- Best for: Tactical planning
- Requires: Feasibility assessment
6. **Custom** - Provide your own criteria
- Example: "Rank by technical complexity" or "Rank by customer segment"
Which criteria would you like to use? [1-6 or describe custom]
Wait for user selection.
Step 3: Apply Ranking Criteria
Based on user's choice:
If Frequency (Option 1):
- Simply re-sort themes by mention count
- No additional analysis needed
If Impact (Option 2):
Use the insight-ranker agent to:
- Review each theme
- Assess potential impact (pain point severity, opportunity size)
- Rank accordingly
If Relevance to ICP (Option 3):
Ask for ICP document:
Please provide path to your ICP document, or I'll look for:
- icp.md
- ideal-customer-profile.md
- customer-profile.md
in the analysis directory
Then use insight-ranker agent to:
- Read ICP document
- Score each theme by alignment with ICP characteristics
- Rank by relevance score
If Business Value (Option 4):
Prompt user for context:
To rank by business value, I need to understand:
1. Revenue impact indicators (which themes suggest upsell/retention opportunities?)
2. Strategic priorities (which align with company goals?)
Please provide:
- Business goals document, OR
- Quick description of strategic priorities
Or I can make best-effort assessment based on theme content.
If Custom (Option 6):
Ask user to clarify:
Please describe your custom ranking criteria:
Example: "Rank by technical complexity, easiest first"
Example: "Rank by enterprise vs SMB relevance"
Example: "Rank by urgency based on competitive pressure"
Then use insight-ranker agent with custom instructions.
Step 4: Present Re-Ranked Results
## ✅ Insights Re-Ranked: [Criteria]
### New Ranking:
#### #1: [Theme Name]
**Previous rank:** #[old position]
**Score:** [Score based on criteria] / 10
**Why this ranking:** [Brief explanation of why it ranks here]
**Key insight:** [One sentence summary]
---
#### #2: [Theme Name]
[Same format...]
---
[Continue for all themes]
---
## Ranking Changes
**Moved up:**
- [Theme]: #[old] → #[new] (↑[change])
**Moved down:**
- [Theme]: #[old] → #[new] (↓[change])
**Stayed same:**
- [Theme]: #[position]
---
## Next Steps
Would you like to:
1. Save this new ranking to file (updates original or creates new)
2. Compare rankings side-by-side (original vs new)
3. Try different criteria
4. Export top 3 insights as summary
Step 5: Save or Export (Optional)
If user chooses to save:
Options:
1. ✅ Update original file ($1) with new ranking
2. 📄 Save as new file (analysis/$1-reranked-[criteria].md)
3. 📋 Just show me the ranking (don't save)
Which would you prefer?
Error Handling
If analysis file doesn't exist:
❌ Analysis file not found: $1
Available analysis files in current directory:
- [file1]
- [file2]
Usage: /rank-insights [analysis-file] [--criteria]
If insufficient data for chosen criteria:
⚠️ Not enough data to rank by "[criteria]"
This ranking method requires:
- [What's needed]
Would you like to:
1. Choose different criteria
2. Provide required context
3. Cancel
Usage Examples
# Rank by frequency (simplest)
/rank-insights analysis/customer-research-analysis.md --criteria frequency
# Rank by ICP relevance
/rank-insights analysis/interviews-analysis.md --criteria relevance
# Custom ranking
/rank-insights analysis/feedback-analysis.md --criteria "urgency based on churn risk"
Tips for Effective Ranking
Frequency ranking:
- Good for: Identifying consensus themes
- Watch out for: Silent but critical minority opinions
Impact ranking:
- Good for: Prioritizing action items
- Consider: Both pain severity and opportunity size
Relevance ranking:
- Good for: Focusing on target audience
- Requires: Well-defined ICP
Custom ranking:
- Most flexible
- Best when you have specific strategic context
- Examples: "competitive urgency", "implementation cost", "customer segment"