icp-website-review

# ICP Website Review

Evaluate any online asset through the eyes of pre-built synthetic ICP personas. This is the evaluation engine — it loads personas created by `buyer-persona-generator` and runs them against whatever you point it at.

## Prerequisites

Personas must exist at `clients/<client>/personas/personas.json`. If they don't, run `buyer-persona-generator` first.

## Quick Start

**Structured scorecard (default):**
```
Review [company]'s website using their ICP personas. Site: [url].
```

**Freeform focus group:**
```
Run a focus group on [company]'s new landing page: [url]. Use focus-group mode.
```

**Head-to-head competitive:**
```
Compare [company]'s site ([url]) against [competitor] ([url]) through ICP personas.
```

## Inputs

| Input | Required | Source |
|-------|----------|--------|
| **Personas** | Yes | `clients/<client>/personas/personas.json` |
| **Target URL(s)** | Yes | User provides |
| **Mode** | No | `scorecard` (default), `focus-group`, or `head-to-head` |
| **Competitor URL(s)** | For head-to-head | User provides |
| **Specific pages** | No | Default: homepage + key pages discovered during crawl |
| **Scope** | No | `full-site` (default) or specific page URL for a single-page review |

## Modes

### Mode 1: Structured Scorecard (Default)

Rigorous, dimension-by-dimension evaluation with numerical scores. Best for:
- Pre-redesign audits
- Conversion optimization
- Tracking improvement over time (comparable scores across runs)
- Stakeholder presentations (data-driven)

### Mode 2: Freeform Focus Group

Each persona reacts naturally — stream of consciousness, emotional reactions, questions they'd have, things that confuse them. No rigid scoring. Best for:
- Early-stage feedback on a draft or concept
- Understanding emotional reactions and gut feelings
- Surfacing unexpected issues the scorecard dimensions might miss
- More natural, human-sounding feedback

### Mode 3: Head-to-Head Competitive

Each persona evaluates your site AND a competitor's site, then picks a winner with reasoning. Best for:
- Competitive positioning
- Understanding why prospects choose competitors
- Finding specific areas where competitors outperform you
- Sales battlecard input

---

## Process

### Step 1: Load Personas

Read `clients/<client>/personas/personas.json`. Confirm:
- Personas exist and are well-formed
- List the personas that will be used (name, title, segment)
- If the user wants to use only specific personas, filter accordingly

### Step 2: Crawl Target Pages

Fetch the key pages each persona would realistically visit:

1. **Homepage** (everyone starts here)
2. **Pricing page** (if public)
3. **Product/features page** (technical buyers)
4. **Solutions/use-cases page** (business buyers)
5. **About page** (trust/credibility check)
6. **Case studies or testimonials** (social proof)
7. **Blog** (1-2 recent posts, for content quality signal)
8. **Documentation or resources** (if relevant for technical buyers)

Use `WebFetch` for each page. Extract main content, headlines, CTAs, and overall structure. Note what's present and what's missing.

Also check external presence:
- **Search results**: WebSearch "[company name]" and "[company name] reviews"
- **Review sites**: Quick G2/Capterra check
- **Social proof signals**: Notable logos, press, trust badges

For **head-to-head mode**, crawl the same pages on the competitor site.

### Step 3: Run Evaluations (Mode-Dependent)

---

#### Scorecard Mode

For each persona, evaluate on these dimensions:

**A) First Impression (10 seconds)**
- What do they think this company does?
- Is it clear this is for them?
- Does the headline speak to their pain point?
- Trust level at first glance?
- **Rating: 1-10**

**B) Messaging Relevance**
- Does the value proposition resonate with their specific pain?
- Is the language familiar or alienating?
- Do they see themselves in the messaging?
- Are benefits framed in terms they care about?
- **Rating: 1-10**

**C) Trust & Credibility**
- Social proof relevant to them? (Same industry, size, role)
- Claims backed by evidence?
- Team/about page build confidence?
- Any red flags?
- **Rating: 1-10**

**D) Clarity & Information Architecture**
- Can they find what they need quickly?
- Is the product easy to understand?
- Is pricing clear?
- Are next steps obvious?
- **Rating: 1-10**

**E) Objection Handling**
- Does the site address their likely objections?
- Comparison pages or differentiators available?
- Enough depth for their decision process?
- **Rating: 1-10**

**F) Overall Verdict**
- Would they take the next step?
- What's the #1 blocker?
- Single most impactful improvement?
- **Overall score: 1-10**

---

#### Focus Group Mode

For each persona, produce a natural, first-person reaction. No rigid structure — let the persona talk.

**Prompt each persona with:**
> You are [persona name], [title] at [company type]. [Situation summary]. You just landed on this website. React naturally — what do you notice first? What confuses you? What excites you? What makes you skeptical? Would you keep exploring or bounce? If you stayed, where would you go next? What questions do you need answered before you'd take action?

**Guidelines:**
- Write in first person as the persona
- Let their personality and skepticism level come through
- Include emotional reactions ("this immediately makes me nervous because...")
- Reference specific things on the page ("the headline says X but I was looking for Y")
- Note what they'd do next ("I'd probably Google '[competitor] vs [company]' after seeing this")
- End with a gut-level verdict: interested, skeptical, confused, or gone

After all personas react, synthesize common themes and divergent opinions.

---

#### Head-to-Head Mode

For each persona, evaluate BOTH sites, then compare.

**Structure per persona:**

1. **Quick take on Site A** (3-5 bullet reactions)
2. **Quick take on Site B** (3-5 bullet reactions)
3. **Dimension-by-dimension comparison:**

| Dimension | Site A | Site B