# /distribution-seo-content — SEO Content Machine Playbook

## Usage
```
/distribution-seo-content                # Full SEO content strategy
/distribution-seo-content comparison     # Comparison pages only
/distribution-seo-content alternatives   # Alternative pages only
/distribution-seo-content howto          # How-to guides only
```

## Input
- `$ARGUMENTS` — optional: specific content type to focus on

## Process

### Step 1: Load Context
1. Read `data/competitors.json` — competitor names, SEO keywords, features
2. Read `data/positioning.json` — our differentiators, target audience, pain points
3. Read `data/business-context.json` — product name, category, funnels
4. Read `data/pages.json` — existing pages to avoid duplication

### Step 2: Keyword Research
Use WebSearch to find keyword opportunities:

**Comparison Keywords:**
- `"[product] vs [competitor]"` — for each competitor
- `"[product] vs [competitor] comparison"` — check if these pages rank
- `"[competitor] alternative"` — capture competitor-dissatisfied users

**Alternative Keywords:**
- `"best [product category] tools [year]"`
- `"[product category] alternatives"`
- `"[incumbent] alternatives"` — for each major player
- `"top [product category] software"`

**Problem-Aware Keywords:**
- `"how to [solve pain point]"`
- `"how to [use case] with AI"`
- `"[pain point] solution for [target audience]"`

**Use-Case Keywords:**
- `"[product category] for [persona]"` (e.g., "AI product manager for solo founders")
- `"[product category] for [industry]"`

For each keyword, estimate via WebSearch:
- Monthly search volume
- Competition level
- Current top-ranking pages (to understand content expectations)
- Search intent (informational/commercial/transactional)

### Step 3: Classify Keywords by Intent
Group keywords into content types:

| Intent | Content Type | Priority | Example |
|--------|-------------|----------|---------|
| Commercial | Comparison page | High | "[Product] vs [Competitor]" |
| Commercial | Alternative page | High | "Best [category] tools" |
| Informational | How-to guide | Medium | "How to [solve problem]" |
| Informational | Use-case page | Medium | "[Product] for [persona]" |
| Transactional | Landing page | High | "[Product category] software" |

### Step 4: Content Briefs (Top 10 Keywords)
For each high-priority keyword, generate a content brief:

**Comparison Pages ("[Product] vs [Competitor]"):**
- H1: "[Product] vs [Competitor]: [Key Difference]"
- Sections: Overview, Feature comparison table, Pricing, Pros/cons, Use cases, Verdict
- Schema markup: Product, Review, FAQ
- Internal links to feature pages and pricing
- CTA: "Try [Product] free" with UTM

**Alternative Pages ("Best [category] tools"):**
- H1: "Best [Category] Tools in [Year]: Complete Guide"
- Sections: Our picks (us first), detailed reviews, comparison table, how to choose
- Schema markup: ItemList, Product
- Include 5-8 tools (us + competitors)
- CTA: "Start with [Product]" with UTM

**How-To Guides:**
- H1: "How to [Solve Problem] with [Product]"
- Sections: Problem statement, Step-by-step solution, Screenshots, FAQ
- Schema markup: HowTo, FAQ
- Internal links to relevant feature pages
- CTA: contextual within the guide

**Use-Case Pages:**
- H1: "[Product] for [Persona]: [Key Benefit]"
- Sections: Pain points for persona, How [Product] solves them, Testimonials, Pricing
- Schema markup: Product, FAQ
- Tailored messaging per persona

### Step 5: Internal Linking Strategy
- Each new page links to 2-3 existing pages
- Update existing pages to link to new content
- Create a hub-and-spoke structure around main category page
- Ensure all comparison pages link to pricing

### Step 6: Schema Markup
For each page type, include:
- **Comparison:** Product schema for both products, FAQ schema
- **Alternative:** ItemList schema, Product schema per item
- **How-to:** HowTo schema with steps, FAQ schema
- **Use-case:** Product schema, FAQ schema

### Step 7: Output
For each content piece, create an idea in `data/ideas.json`:
- Category: "growth"
- Tags: ["growth", "seo", "{content-type}", "{target-keyword}"]
- Implementation plan with content brief
- Success metrics: organic traffic, keyword ranking, time on page, conversion rate
- Queue `/build-page {slug}` for top priority pages
- UTM: `utm_source=organic&utm_medium=seo&utm_campaign={page-slug}`

## Output Files
- `data/ideas.json` — SEO content machine ideas