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"