Sub-Agent Architecture Roadmap

# Sub-Agent Architecture Roadmap

**Document Purpose:** Complete specification of all sub-agents in the agentic SEO system architecture.

**Date Created:** 2025-10-17

**Status:** Design specification and implementation roadmap

---

## System Overview

**Total Sub-Agents:** 24 (7 existing + 17 new)

**Architecture Principles:**
1. **Single Responsibility** - Each agent has one focused purpose
2. **Composability** - Agents can be combined by orchestrator for complex workflows
3. **Isolation** - Agents work independently with no conversation history
4. **Structured I/O** - Clear input requirements and structured output formats
5. **Parallel Execution** - Maximize concurrent agent execution where possible
6. **Context Efficiency** - Manage context window usage through focused scopes

---

## Existing Sub-Agents (7)

### ✅ 1. business-profile-creator
**Status:** Implemented
**Purpose:** Research and document business context, value propositions, target audience
**Triggers:** User starts new client work, initializes business context
**Output Location:** `/context/business-profile.md`

### ✅ 2. competitor-identifier
**Status:** Implemented
**Purpose:** Identify and list main competitors with URLs
**Triggers:** Competitive research, before landscape analysis
**Output Location:** `/context/competitors.md`

### ✅ 3. competitive-landscape-analyzer
**Status:** Implemented
**Purpose:** Deep competitive analysis with strategic insights
**Triggers:** Strategic planning, competitive positioning work
**Output Location:** `/analysis/competitive-landscape-{DATE}.md`

### ✅ 4. keyword-researcher
**Status:** Implemented
**Purpose:** Comprehensive keyword discovery for specific topics
**Triggers:** Keyword research requests, topic exploration
**Output Location:** `/analysis/keyword-research-{TOPIC}-{DATE}.md`

### ✅ 5. brand-style-guide-researcher
**Status:** Implemented
**Purpose:** Research and document brand voice, tone, style guidelines
**Triggers:** Before content creation, style guide missing
**Output Location:** `/context/style-guide.md`

### ✅ 6. content-writer
**Status:** Implemented
**Purpose:** Create on-brand content (blog posts, landing pages, etc.)
**Triggers:** Content creation requests
**Output Location:** `/deliverables/content/{content-type}-{topic}-{DATE}.md`

### ✅ 7. content-editor
**Status:** Implemented
**Purpose:** Edit and optimize content for quality, brand alignment, SEO
**Triggers:** Content review, optimization, updating requests
**Output Location:** Updates files in place or creates new versions

---

## New Sub-Agents Specifications (17)

### 🆕 8. technical-seo-auditor

**Purpose:** Conduct comprehensive technical SEO audits with prioritized recommendations

**When to Trigger:**
- User requests technical SEO audit
- "What are the technical issues on this site?"
- "Prioritize technical SEO improvements"
- Before strategy development
- Periodic site health checks

**Primary Responsibilities:**
- Crawl and analyze site structure
- Identify crawlability and indexability issues
- Assess mobile optimization and Core Web Vitals
- Review robots.txt, sitemaps, canonical tags
- Analyze redirect chains and broken links
- Check HTTPS implementation and security
- Evaluate JavaScript rendering and SEO
- Assess schema markup implementation
- Identify duplicate content issues
- Prioritize issues by severity and impact

**Input Requirements:**
- Website URL (required)
- Business context from business-profile.md (if available)
- Focus areas (optional: mobile, speed, crawlability, etc.)
- Current known issues (optional)

**Output Format:**
```markdown
# Technical SEO Audit Report

**Website:** [URL]
**Audit Date:** [DATE]
**Audit Scope:** [Full site | Specific sections]

## Executive Summary
[High-level overview of technical health with severity breakdown]

## Critical Issues (P0)
[Issues requiring immediate attention with significant SEO impact]

## High Priority Issues (P1)
[Important issues that should be addressed soon]

## Medium Priority Issues (P2)
[Issues to address but with lower immediate impact]

## Optimization Opportunities
[Enhancements beyond issue fixes]

## Detailed Findings by Category
### Crawlability & Indexability
### Site Architecture
### Mobile & Performance
### Schema & Structured Data
### Technical Best Practices

## Prioritized Action Plan
[Sequenced implementation roadmap with effort estimates]
```

**Output Location:** `/analysis/technical-seo-audit-{DATE}.md`

**Dependencies:** None (standalone analysis)

**Parallel Opportunities:** Can run simultaneously with backlink-analyzer, content-gap-analyzer

**Model Recommendation:** Sonnet (balance of analysis depth and cost)

**Color:** Red (technical/critical work)

---

### 🆕 9. keyword-strategist

**Purpose:** Transform keyword research into strategic plans with clustering, mapping, and prioritization

**When to Trigger:**
- After keyword-researcher completes discovery
- "Organize these keywords into clusters"
- "Map keywords to our pages"
- "Prioritize keyword targets"
- Content planning phase

**Primary Responsibilities:**
- Group keywords into semantic clusters
- Categorize by search intent (informational, commercial, transactional, navigational)
- Map keywords to existing pages or identify page gaps
- Prioritize keywords by opportunity score (volume, difficulty, business value)
- Create keyword targeting roadmap
- Align keywords with content types and user journey stages
- Identify quick wins vs. long-term targets

**Input Requirements:**
- Keyword research data from keyword-researcher (required)
- Business profile for context (required)
- Current site structure and page inventory (required)
- Business goals and KPIs (optional but recommended)
- Resource constraints (optional)

**Output Format:**
```markdown
# Keyword Strategy

**Brand:** [BRAND NAME]
**Date:** [DATE]
**Source Keywords:** [NUMBER] keywords from keyword research

## Keyword Clusters

### Cluster 1: [CLUSTER NAME]
**Primary Intent:** [Intent type]
**Priority:** High/Medium/Low
**Opportunity Score:** [Score/10]

| Keyword | Volume | Difficulty | Intent | Mapped Page | Priority | Notes |
|---------|--------|------------|--------|-------------|----------|-------|

### [Additional clusters...]

## Keyword-to-Page Mapping

### Existing Pages to Optimize
[Pages with keyword mappings]

### New Pages Needed
[Gap pages required with keyword clusters]

## Strategic Priorities

### Quick Wins (0-3 months)
[Low-competition, high-relevance keywords]

### Medium-Term Targets (3-6 months)
[Moderate competition, strategic value]

### Long-Term Aspirational (6-12 months)
[High competition, high value]

## Content Type Recommendations
[Keywords best suited for blog posts, guides, landing pages, tools, etc.]
```

**Output Location:** `/analysis/keyword-strategy-{DATE}.md`

**Dependencies:** keyword-researcher (requires completed keyword research)

**Parallel Opportunities:** Can run in parallel with content-gap-analyzer after keyword research completes

**Model Recommendation:** Sonnet (strategic analysis)

**Color:** Purple (strategy/planning)

---

### 🆕 10. keyword-gap-analyzer

**Purpose:** Identify keyword opportunities where competitors rank but you don't

**When to Trigger:**
- "Find keyword gaps vs competitors"
- "What keywords do competitors rank for that we don't?"
- After competitor identification
- Competitive keyword research phase

**Primary Responsibilities:**
- Compare own keyword rankings vs. competitor rankings
- Identify keywords where competitors have visibility but client doesn't
- Assess relevance and opportunity for each gap keyword
- Estimate traffic potential of gap keywords
- Categorize gaps by intent and business value
- Prioritize gap keywords for content creation
- Identify patterns in keyword gaps (topic areas, content types)

**Input Requirements:**
- Own keyword rankings or site context (required)
- Competitor list from competitors.md (required)
- Competitor keyword data (required - from keyword-researcher with competitor focus)
- Business profile for relevance assessment (required)

**Output Format:**
```markdown
# Keyword Gap Analysis

**Brand:** [BRAND NAME]
**Date:** [DATE]
**Competitors Analyzed:** [LIST]

## Executive Summary
- Total gap keywords identified: [NUMBER]
- High-priority opportunities: [NUMBER]
- Primary gap categories: [THEMES]

## Gap Keywords by Priority

### High Priority Gaps
[Keywords with high volume, relevance, and winability]

| Keyword | Competitor(s) Ranking | Est. Volume | Difficulty | Business Value | Gap Type | Recommended Action |
|---------|----------------------|-------------|------------|----------------|----------|-------------------|

### Medium Priority Gaps
[Moderate opportunity keywords]

### Low Priority Gaps
[Lower immediate value but worth monitoring]

## Gap Analysis by Topic Cluster
[Grouped view of gaps showing topic areas]

## Gap Analysis by Competitor
[Which competitors are strongest in which keyword areas]

## Content Recommendations
[What content types/topics would address the most valuable gaps]

## Strategic Insights
[Patterns observed, strategic implications]
```

**Output Location:** `/analysis/keyword-gap-analysis-{DATE}.md`

**Dependencies:**
- competitor-identifier (requires competitor list)
- keyword-researcher (requires competitor keyword data)

**Parallel Opportunities:** Can run in parallel with content-gap-analyzer, backlink-analyzer

**Model Recommendation:** Sonnet (analytical work)

**Color:** Orange (competitive analysis)

---

### 🆕 11. content-gap-analyzer

**Purpose:** Identify content topics and formats where competitors have coverage but you don't

**When to Trigger:**
- "What content do competitors have that we don't?"
- "Find content gaps"
- Content strategy planning
- After competitive landscape analysis

**Primary Responsibilities:**
- Inventory competitor content (topics, formats, depth)
- Inventory own content
- Identify topics competitors cover that client doesn't
- Identify content formats competitors use effectively (guides, tools, videos, etc.)
- Assess content quality and depth differences
- Prioritize gaps by strategic value
- Recommend content creation priorities
- Map content gaps to keyword opportunities

**Input Requirements:**
- Competitor list from competitors.md (required)
- Own content inventory or site URL (required)
- Keyword strategy data (optional but helpful)
- Business profile for relevance (required)

**Output Format:**
```markdown
# Content Gap Analysis

**Brand:** [BRAND NAME]
**Date:** [DATE]
**Competitors Analyzed:** [LIST]
**Own Content Analyzed:** [NUMBER] pages/pieces

## Executive Summary
- Total content gaps identified: [NUMBER]
- Priority gaps for immediate action: [NUMBER]
- Content types most needed: [LIST]

## Content Gaps by Topic Category

### Category 1: [CATEGORY NAME]
**Strategic Value:** High/Medium/Low
**Competitor Coverage:** [Who has content here]
**Our Coverage:** [Current state]

| Topic | Competitors with Content | Format | Estimated Traffic Potential | Priority | Notes |
|-------|-------------------------|--------|----------------------------|----------|-------|

## Content Format Gaps
[Where competitors use formats we don't: video, interactive tools, calculators, etc.]

## Content Depth Gaps
[Where our content exists but is shallower than competitors]

## Content Freshness Gaps
[Topics where competitors have recent content and ours is outdated or missing]

## Prioritized Content Recommendations

### Immediate Priorities (0-30 days)
[High-impact, high-feasibility content gaps]

### Short-Term (30-90 days)
[Strategic content that requires more resources]

### Long-Term (90+ days)
[Complex content assets with significant investment]

## Strategic Insights
[Patterns in gaps, competitive positioning implications]
```

**Output Location:** `/analysis/content-gap-analysis-{DATE}.md`

**Dependencies:**
- competitor-identifier (requires competitor list)
- competitive-landscape-analyzer (helpful for context)

**Parallel Opportunities:** Can run in parallel with keyword-gap-analyzer, backlink-analyzer

**Model Recommendation:** Sonnet (content analysis)

**Color:** Teal (content strategy)

---

### 🆕 12. content-brief-creator

**Purpose:** Create detailed, SEO-optimized content briefs for writers

**When to Trigger:**
- "Create a content brief for [topic]"
- Before content creation
- After keyword strategy is defined
- Content calendar execution

**Primary Responsibilities:**
- Define content topic, angle, and format
- Specify target keywords and semantic terms
- Outline recommended content structure
- Research SERP analysis and competitor content
- Define target audience and user intent
- Specify word count and content depth
- Include talking points and key information to cover
- Suggest internal/external links
- Provide SEO requirements (meta tags, headers, etc.)
- Include brand voice/tone guidelines reference

**Input Requirements:**
- Target topic and keywords (required)
- Business profile and style guide (required)
- Keyword strategy data (optional but helpful)
- SERP analysis for target keyword (optional but helpful)
- Competitor content analysis (optional)

**Output Format:**
```markdown
# Content Brief: [TITLE]

**Date Created:** [DATE]
**Created For:** [BRAND NAME]
**Content Type:** [Blog post | Guide | Landing page | etc.]
**Target Keywords:** [PRIMARY], [Secondary], [Tertiary]
**Target Audience:** [Audience description]
**Search Intent:** [Informational | Commercial | Transactional | Navigational]

## Content Objectives
- Primary goal: [What should this content achieve?]
- Target metrics: [Traffic, conversions, rankings, etc.]

## SEO Specifications
- **Target Word Count:** [Range]
- **Primary Keyword:** [Keyword] - Use in: Title, H1, First paragraph, Naturally throughout
- **Secondary Keywords:** [List] - Include naturally
- **Semantic Terms:** [Related terms to include for topical depth]

## Content Structure

### Recommended Outline
1. **Title Options:** [3-5 optimized title suggestions]
2. **Introduction** (150-200 words)
   - Hook: [Suggested opening]
   - Context: [What problem/topic]
   - Value prop: [Why read this]
3. **Main Content Sections:**
   - H2: [Section title]
     - H3: [Subsection]
     - Key points to cover: [Bullets]
   - [Additional sections...]
4. **Conclusion**
   - Summary of key takeaways
   - Call-to-action: [Specific CTA]

## SERP Analysis Insights
- Current top-ranking content format: [Format]
- Average length of top 10: [Words]
- Common sections in top content: [List]
- SERP features present: [Featured snippet, PAA, etc.]
- Opportunity to differentiate: [Unique angle]

## Competitor Content Review
- **Competitor 1:** [URL] - Strengths: [X], Gaps: [Y]
- **Competitor 2:** [URL] - Strengths: [X], Gaps: [Y]
- **Our Differentiation:** [How to create better content]

## Key Information to Include
- [Specific points, data, examples that must be covered]

## Internal Linking Opportunities
- Link to: [Relevant internal pages with anchor text suggestions]

## External Reference Sources
- [Credible sources for research and citation]

## Visual Asset Recommendations
- [Images, diagrams, screenshots needed]

## Meta Data
- **Meta Title (60 chars):** [Suggestion]
- **Meta Description (160 chars):** [Suggestion]

## Brand Voice Guidelines
- Tone: [Reference to style guide]
- Terminology preferences: [Specific terms to use/avoid]

## Success Criteria
- Content should rank top 10 for: [Primary keyword]
- Target engagement: [Time on page, scroll depth]
- Target conversion: [Specific action]
```

**Output Location:** `/deliverables/content-briefs/brief-{topic-slug}-{DATE}.md`

**Dependencies:**
- keyword-strategist (for keyword targeting)
- brand-style-guide-researcher (for brand voice)
- serp-analyzer (optional for SERP insights)

**Parallel Opportunities:** Can create multiple briefs in parallel for different topics

**Model Recommendation:** Sonnet (detailed analytical work)

**Color:** Green (content creation enablement)

---

### 🆕 13. internal-linking-strategist

**Purpose:** Analyze site structure and create strategic internal linking recommendations

**When to Trigger:**
- "Optimize internal linking"
- "Improve site architecture for SEO"
- After content creation
- Site audit findings
- Authority distribution needs

**Primary Responsibilities:**
- Analyze current internal linking structure
- Identify orphan pages and poor link distribution
- Recommend internal links to improve authority flow
- Suggest anchor text for internal links
- Create topic cluster linking structures
- Identify hub pages that should receive more internal links
- Recommend internal links for new content
- Prioritize linking opportunities by impact

**Input Requirements:**
- Website URL or site structure (required)
- Page inventory and content types (required)
- Keyword mapping data (helpful)
- Business priorities (which pages to boost) (optional)

**Output Format:**
```markdown
# Internal Linking Strategy

**Website:** [URL]
**Date:** [DATE]
**Pages Analyzed:** [NUMBER]

## Current State Analysis
- Total internal links: [NUMBER]
- Average links per page: [NUMBER]
- Orphan pages identified: [NUMBER]
- Pages with excessive links: [NUMBER]

## Issues Identified

### Orphan Pages
[Pages with no or minimal internal links]

### Under-Linked Priority Pages
[Important pages not receiving enough authority]

### Over-Optimized Anchor Text
[Areas with repetitive exact-match anchors]

## Topic Cluster Recommendations

### Cluster 1: [TOPIC]
**Pillar Page:** [URL]
**Supporting Pages:** [URLs]

| From Page | To Page | Recommended Anchor Text | Priority | Rationale |
|-----------|---------|------------------------|----------|-----------|

## Priority Internal Linking Opportunities

### High Priority (Implement Immediately)
[Links that will have significant impact]

### Medium Priority (Next 30 days)
[Important but less urgent links]

### Low Priority (Ongoing optimization)
[Nice-to-have improvements]

## Anchor Text Guidelines
[Recommended anchor text variations and patterns]

## Authority Distribution Strategy
[How to flow authority to priority pages]

## Implementation Checklist
- [ ] Add internal links from [specific pages]
- [ ] Update navigation for better crawlability
- [ ] Create supporting content for weak clusters
```

**Output Location:** `/analysis/internal-linking-strategy-{DATE}.md`

**Dependencies:**
- site-architecture-analyst (helpful for understanding structure)
- keyword-strategist (helpful for anchor text guidance)

**Parallel Opportunities:** Can run after technical-seo-auditor completes

**Model Recommendation:** Sonnet (analytical work)

**Color:** Blue (structure/architecture)

---

### 🆕 14. meta-optimizer

**Purpose:** Audit and optimize meta titles and descriptions at scale

**When to Trigger:**
- "Optimize meta tags"
- "Improve click-through rates from search"
- After keyword mapping
- Technical audit identifies meta tag issues
- New page creation

**Primary Responsibilities:**
- Audit existing meta titles and descriptions
- Identify missing, duplicate, or poorly optimized meta tags
- Create optimized meta titles (within character limits)
- Create compelling meta descriptions (within character limits)
- Ensure keyword inclusion and brand consistency
- Optimize for click-through rate
- Align meta tags with search intent
- Check for title tag truncation in SERPs
- Provide bulk optimization recommendations

**Input Requirements:**
- Website URL or page list (required)
- Target keywords by page (required)
- Brand guidelines and name usage rules (required)
- Current meta tag data (helpful)

**Output Format:**
```markdown
# Meta Tag Optimization Report

**Website:** [URL]
**Date:** [DATE]
**Pages Analyzed:** [NUMBER]

## Audit Summary
- Pages with missing titles: [NUMBER]
- Pages with missing descriptions: [NUMBER]
- Pages with duplicate titles: [NUMBER]
- Pages with duplicate descriptions: [NUMBER]
- Pages with too-long titles: [NUMBER]
- Pages with too-short titles: [NUMBER]

## Critical Issues
[Pages requiring immediate attention]

## Optimized Meta Tags by Page

### Page: [URL]
**Target Keywords:** [Primary], [Secondary]

**Current Title:** [Existing title - X chars]
**Optimized Title:** [New title - X chars] ✅
**Rationale:** [Why this is better]

**Current Description:** [Existing - X chars]
**Optimized Description:** [New description - X chars] ✅
**Rationale:** [Why this is better]

---

### [Additional pages...]

## Meta Title Template Recommendations
[Patterns for different page types]
- Product pages: [Template]
- Category pages: [Template]
- Blog posts: [Template]
- Service pages: [Template]

## Meta Description Template Recommendations
[Patterns for different page types with CTA suggestions]

## Brand Name Usage Guidelines
[When and how to include brand name in titles]

## Implementation Priority

### Priority 1: High-Traffic Pages
[Pages with significant traffic needing optimization]

### Priority 2: Target Keyword Pages
[Pages targeting priority keywords]

### Priority 3: Remaining Pages
[Bulk optimization for other pages]

## Expected Impact
- Estimated CTR improvement: [X%]
- Pages with improved relevance: [NUMBER]
```

**Output Location:** `/deliverables/meta-optimization-{DATE}.md`

**Dependencies:**
- keyword-strategist (for keyword-to-page mapping)
- brand-style-guide-researcher (for brand voice in meta)

**Parallel Opportunities:** Can run in parallel with schema-strategist after keyword mapping

**Model Recommendation:** Sonnet (at-scale optimization work)

**Color:** Cyan (optimization)

---

### 🆕 15. schema-strategist

**Purpose:** Recommend schema markup implementations for better SERP visibility

**When to Trigger:**
- "Implement structured data"
- "Add schema markup"
- Technical audit identifies schema opportunities
- Rich snippet targeting
- New page type creation

**Primary Responsibilities:**
- Audit existing schema implementation
- Identify schema opportunities by page type
- Recommend specific schema types (Organization, Product, Article, FAQ, etc.)
- Provide schema markup code examples
- Prioritize schema implementation by impact
- Ensure schema validation compliance
- Recommend testing and validation process
- Align schema with SERP feature opportunities

**Input Requirements:**
- Website URL or page inventory (required)
- Content types present (blog, product, local, etc.) (required)
- Business information for Organization schema (required)
- SERP feature goals (optional)

**Output Format:**
```markdown
# Schema Markup Strategy

**Website:** [URL]
**Date:** [DATE]
**Current Schema:** [Types currently implemented]

## Schema Audit Summary
- Pages with schema: [NUMBER / TOTAL]
- Schema types in use: [LIST]
- Schema errors found: [NUMBER]
- Schema opportunities identified: [NUMBER]

## Critical Schema Issues
[Errors that need immediate fixing]

## Schema Recommendations by Priority

### Priority 1: Essential Schema (Implement Immediately)

#### Organization Schema (Site-wide)
**Purpose:** Establish brand identity in knowledge graph
**Implementation:** Add to homepage or site-wide header
**Expected Impact:** Brand SERP features, knowledge panel

```json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[BRAND NAME]",
  "url": "[URL]",
  "logo": "[LOGO URL]",
  ...
}
```

#### [Additional priority 1 schemas...]

### Priority 2: High-Value Schema (30-day implementation)

#### Product Schema (E-commerce)
**Pages:** Product pages
**Purpose:** Rich snippets with price, reviews, availability
**Expected Impact:** Improved CTR, shopping features

```json
{
  "@context": "https://schema.org",
  "@type": "Product",
  ...
}
```

### Priority 3: Optimization Schema (Ongoing)
[Additional schema types for further optimization]

## Schema by Page Type

### Homepage
- Organization schema
- Sitelinks SearchBox schema

### Product Pages (if applicable)
- Product schema
- Review/Rating schema
- Offer schema

### Blog Posts
- Article schema
- Author schema
- BreadcrumbList schema

### Service Pages
- Service schema
- LocalBusiness schema (if applicable)

### FAQ Pages
- FAQPage schema

## Implementation Guide

### Tools for Testing
- Google Rich Results Test: [URL]
- Schema.org Validator: [URL]

### Implementation Methods
1. JSON-LD in <head> (recommended)
2. Microdata in HTML
3. RDFa

### Quality Checklist
- [ ] All required properties included
- [ ] No validation errors
- [ ] Tested in Rich Results Test
- [ ] Deployed to production
- [ ] Monitoring in Search Console

## Expected SERP Feature Opportunities
[Which rich results this schema could generate]

## Monitoring and Maintenance
[How to track schema performance and keep it updated]
```

**Output Location:** `/deliverables/schema-strategy-{DATE}.md`

**Dependencies:**
- technical-seo-auditor (for current state)
- serp-analyzer (for SERP feature opportunities)

**Parallel Opportunities:** Can run in parallel with meta-optimizer

**Model Recommendation:** Sonnet (technical specifications)

**Color:** Purple (technical enhancement)

---

### 🆕 16. backlink-analyzer

**Purpose:** Analyze backlink profiles for own site and competitors

**When to Trigger:**
- "Analyze backlink profile"
- "Where are competitors getting links?"
- Off-page SEO audit
- Link building strategy development
- Domain authority concerns

**Primary Responsibilities:**
- Analyze own backlink profile (quantity, quality, diversity)
- Identify toxic or spammy backlinks
- Analyze competitor backlink profiles
- Identify link opportunities (where competitors have links)
- Assess referring domain authority and relevance
- Identify link building patterns and opportunities
- Recommend link acquisition strategies
- Prioritize link opportunities by value

**Input Requirements:**
- Own website URL (required)
- Competitor URLs (for competitive analysis)
- Backlink data (from available tools/APIs)
- Business profile for relevance assessment

**Output Format:**
```markdown
# Backlink Profile Analysis

**Website:** [URL]
**Date:** [DATE]
**Analysis Scope:** [Own site | Competitive | Both]

## Own Backlink Profile Summary
- Total backlinks: [NUMBER]
- Referring domains: [NUMBER]
- Follow vs. nofollow: [RATIO]
- Average domain authority: [SCORE]
- Link growth trend: [Trend]

## Backlink Quality Assessment

### High-Quality Backlinks ([NUMBER])
[Valuable links from authoritative, relevant sources]

| Source Domain | URL | DA | Relevance | Link Type | Anchor Text |
|---------------|-----|----|-----------|-----------||-------------|

### Low-Quality/Toxic Backlinks ([NUMBER])
[Potentially harmful links]

| Source Domain | URL | Issue | Recommended Action |
|---------------|-----|-------|-------------------|

## Competitor Backlink Analysis

### Competitor 1: [NAME]
- Backlinks: [NUMBER]
- Referring domains: [NUMBER]
- Top linking domains: [LIST]
- Link building strategies observed: [PATTERNS]

### [Additional competitors...]

## Link Gap Analysis
[Links competitors have that you don't - opportunities]

### High-Priority Link Opportunities

| Opportunity Domain | Links To Competitors | DA | Relevance | Acquisition Strategy | Priority |
|-------------------|---------------------|----|-----------|--------------------|----------|

## Link Building Recommendations

### Immediate Opportunities (0-30 days)
[Easy-to-acquire links]

### Medium-Term Targets (30-90 days)
[Requires outreach or content creation]

### Long-Term Aspirational (90+ days)
[Requires significant effort or relationships]

## Toxic Link Cleanup
[Backlinks to disavow]

## Link Building Strategies by Type

### Resource Links
[Opportunities to get listed on resource pages]

### Guest Posting
[Target publications for guest contributions]

### Broken Link Building
[Competitors' broken links to replace]

### Digital PR
[Newsworthy angles for earned media]

### Partnership/Vendor Links
[Business relationship link opportunities]

## Anchor Text Distribution
[Current anchor text profile and recommendations]

## Link Velocity Recommendations
[Safe link acquisition pace]
```

**Output Location:** `/analysis/backlink-analysis-{DATE}.md`

**Dependencies:**
- competitor-identifier (for competitive analysis)

**Parallel Opportunities:** Can run in parallel with keyword-gap-analyzer, content-gap-analyzer

**Model Recommendation:** Sonnet (analysis work)

**Color:** Orange (competitive/off-page)

---

### 🆕 17. page-speed-analyst

**Purpose:** Analyze page speed and provide specific optimization recommendations

**When to Trigger:**
- "Improve page speed"
- "Optimize Core Web Vitals"
- Technical SEO audit
- Site performance concerns
- Mobile optimization focus

**Primary Responsibilities:**
- Analyze page load performance metrics
- Assess Core Web Vitals (LCP, FID/INP, CLS)
- Identify performance bottlenecks
- Provide specific optimization recommendations
- Prioritize fixes by impact
- Consider mobile vs. desktop performance
- Recommend tools and testing approaches
- Estimate performance improvement impact on SEO

**Input Requirements:**
- Website URL or specific pages (required)
- Performance data (PageSpeed Insights, GTmetrix, etc.) (helpful)
- Technical environment context (CMS, hosting, CDN) (optional)

**Output Format:**
```markdown
# Page Speed Analysis & Optimization

**Website:** [URL]
**Date:** [DATE]
**Pages Analyzed:** [URLs]

## Performance Summary

### Overall Scores
- **Desktop Performance:** [SCORE/100]
- **Mobile Performance:** [SCORE/100]
- **Accessibility:** [SCORE/100]
- **Best Practices:** [SCORE/100]
- **SEO:** [SCORE/100]

### Core Web Vitals
- **LCP (Largest Contentful Paint):** [TIME] - [Status]
- **INP (Interaction to Next Paint):** [TIME] - [Status]
- **CLS (Cumulative Layout Shift):** [SCORE] - [Status]

## Critical Issues (P0)

### 1. [Issue Name]
**Impact:** [High/Medium/Low]
**Current State:** [Specific metrics]
**Expected Improvement:** [Improvement estimate]

**Problem:**
[Detailed description of the issue]

**Solution:**
[Specific steps to fix]

**Implementation:**
```
[Code examples or configuration changes]
```

## High-Priority Optimizations (P1)

### Image Optimization
- Total image weight: [SIZE]
- Images without optimization: [NUMBER]
- **Recommendations:**
  - Implement lazy loading
  - Convert to WebP format
  - Implement responsive images with srcset
  - Compress images (target <100KB each)

### JavaScript Optimization
- Total JS size: [SIZE]
- Render-blocking JS: [NUMBER] files
- **Recommendations:**
  - Defer non-critical JavaScript
  - Remove unused JavaScript ([SIZE] potential savings)
  - Split and lazy-load bundles
  - Minimize third-party scripts

### CSS Optimization
- Total CSS size: [SIZE]
- Render-blocking CSS: [NUMBER] files
- **Recommendations:**
  - Inline critical CSS
  - Defer non-critical CSS
  - Remove unused CSS ([SIZE] potential savings)
  - Minimize CSS files

## Medium-Priority Optimizations (P2)

### Server Response Time
- TTFB (Time to First Byte): [TIME]
- **Recommendations:**
  - Implement/optimize caching
  - Use CDN
  - Optimize database queries
  - Upgrade hosting if needed

### Third-Party Resources
- Third-party requests: [NUMBER]
- Third-party impact: [TIME]
- **Recommendations:**
  - Audit and remove unnecessary third-party scripts
  - Defer or async load third-party resources
  - Use facade pattern for heavy embeds (videos, maps)

### Font Loading
- Web fonts: [NUMBER]
- Font weight: [SIZE]
- **Recommendations:**
  - Use font-display: swap
  - Preload critical fonts
  - Subset fonts to include only needed characters
  - Use system fonts where appropriate

## Page-Specific Recommendations

### Homepage
[Specific optimizations for homepage]

### Product Pages
[Specific optimizations for product pages]

### Blog Posts
[Specific optimizations for blog posts]

## Mobile-Specific Optimizations
[Recommendations specific to mobile performance]

## Implementation Roadmap

### Phase 1: Quick Wins (0-2 weeks)
- [ ] [Optimization task with estimated impact]
- [ ] [Optimization task with estimated impact]

### Phase 2: Moderate Effort (2-6 weeks)
- [ ] [Optimization task with estimated impact]

### Phase 3: Long-Term (6+ weeks)
- [ ] [Optimization task with estimated impact]

## Expected Impact
- **Estimated Performance Improvement:** [X%]
- **Estimated SEO Impact:** [Description]
- **Estimated User Experience Improvement:** [Description]

## Monitoring and Testing
- Tools to use: PageSpeed Insights, GTmetrix, WebPageTest
- Metrics to track: Core Web Vitals, load time, page size
- Testing frequency: [Recommendation]
```

**Output Location:** `/analysis/page-speed-analysis-{DATE}.md`

**Dependencies:**
- technical-seo-auditor (often requested together)

**Parallel Opportunities:** Can run as standalone or after technical audit

**Model Recommendation:** Sonnet (technical analysis)

**Color:** Red (performance/technical)

---

### 🆕 18. content-refresh-prioritizer

**Purpose:** Analyze existing content and prioritize refresh/update opportunities

**When to Trigger:**
- "Which content should we update?"
- "Prioritize content refresh"
- Content performance decline
- Periodic content maintenance
- After algorithm updates

**Primary Responsibilities:**
- Analyze existing content inventory
- Assess content performance (traffic, rankings, engagement)
- Identify content decay and outdated information
- Evaluate content quality vs. current SERP standards
- Prioritize content for refresh by opportunity
- Recommend specific improvements for each piece
- Consider keyword opportunity changes
- Identify content consolidation opportunities

**Input Requirements:**
- Content inventory (URLs of existing content) (required)
- Performance data (traffic, rankings over time) (required)
- Keyword tracking data (optional but helpful)
- Business priorities (optional)

**Output Format:**
```markdown
# Content Refresh Prioritization

**Website:** [URL]
**Date:** [DATE]
**Content Pieces Analyzed:** [NUMBER]

## Analysis Summary
- Content showing decline: [NUMBER]
- Content with refresh opportunity: [NUMBER]
- High-priority refreshes: [NUMBER]
- Content to consolidate: [NUMBER]
- Content to remove: [NUMBER]

## Refresh Priority Ranking

### Priority 1: High-Impact Quick Wins

#### 1. [Content Title]
**URL:** [URL]
**Current Performance:** [Metrics]
**Opportunity Score:** [X/10]
**Estimated Effort:** [Low/Medium/High]

**Issues Identified:**
- [Outdated information]
- [Keyword targeting issues]
- [Content depth vs. competitors]

**Recommended Actions:**
1. [Specific improvement]
2. [Specific improvement]
3. [Specific improvement]

**Expected Impact:**
- Traffic improvement: [Estimate]
- Ranking improvement: [Estimate]

---

### Priority 2: Significant Opportunities (Higher Effort)
[Content requiring more substantial updates]

### Priority 3: Maintenance Updates (Lower Priority)
[Content needing minor updates]

## Content by Issue Type

### Outdated Content
[Content with outdated information, stats, or examples]

### Thin Content
[Content shorter or less comprehensive than competitors]

### Poor Performance Despite Quality
[Good content not ranking well - SEO issues]

### Declining Traffic/Rankings
[Content that previously performed well but is declining]

### Missing Target Keywords
[Content not properly optimized for keyword opportunities]

## Content Consolidation Opportunities
[Similar/overlapping content that should be merged]

| Content Pieces to Merge | Combined Topic | Primary URL | Redirect URLs | Priority |
|------------------------|----------------|-------------|---------------|----------|

## Content Removal Recommendations
[Content that should be deleted or noindexed]

## Refresh Implementation Schedule

### Month 1
- [Content title] - [Owner] - [Due date]
- [Content title] - [Owner] - [Due date]

### Month 2
- [Content title] - [Owner] - [Due date]

### Month 3
- [Content title] - [Owner] - [Due date]

## Success Metrics
- Target: [X%] of prioritized content refreshed in [TIMEFRAME]
- Expected aggregate traffic improvement: [ESTIMATE]
- Expected ranking improvements: [NUMBER] keywords
```

**Output Location:** `/analysis/content-refresh-priorities-{DATE}.md`

**Dependencies:**
- Requires access to performance data
- keyword-strategist (helpful for keyword opportunity assessment)

**Parallel Opportunities:** Standalone analysis, can inform content-editor work

**Model Recommendation:** Sonnet (analytical work)

**Color:** Yellow (content optimization)

---

### 🆕 19. serp-analyzer

**Purpose:** Analyze SERP features, patterns, and ranking factors for target keywords

**When to Trigger:**
- "Analyze SERPs for these keywords"
- "What's ranking for [keyword]?"
- Before content creation
- Content format decisions
- Featured snippet targeting

**Primary Responsibilities:**
- Analyze SERP features present (featured snippets, PAA, local pack, images, videos, etc.)
- Identify content formats ranking (listicles, guides, tools, videos)
- Assess search intent from SERP results
- Analyze competitor rankings and content approaches
- Identify SERP feature capture opportunities
- Determine content requirements to rank (length, depth, format)
- Track SERP volatility and changes
- Recommend content strategies based on SERP analysis

**Input Requirements:**
- Target keywords (required)
- Geographic location for SERP results (optional)
- Device type (mobile/desktop) (optional)

**Output Format:**
```markdown
# SERP Analysis Report

**Date:** [DATE]
**Keywords Analyzed:** [NUMBER]
**Geographic Location:** [LOCATION]

## Executive Summary
- Keywords with featured snippets: [NUMBER]
- Keywords with video results: [NUMBER]
- Keywords with local pack: [NUMBER]
- Dominant content formats: [TYPES]
- Average word count of ranking content: [NUMBER]

## Keyword-by-Keyword Analysis

### Keyword: "[KEYWORD]"
**Search Volume:** [ESTIMATE]
**Difficulty:** [SCORE]
**Search Intent:** [Informational/Commercial/Transactional/Navigational]

#### SERP Features Present
- [x] Featured Snippet (Type: [Paragraph/List/Table/Video])
- [x] People Also Ask (PAA)
- [x] Video Carousel
- [ ] Local Pack
- [x] Images
- [ ] Shopping Results
- [x] Related Searches

#### Top 10 Analysis

| Position | URL | Domain | Content Type | Word Count | Title Format | SERP Features Captured |
|----------|-----|--------|--------------|------------|--------------|----------------------|
| 1 | [URL] | [Domain] | [Guide] | [2500] | [Format] | Featured Snippet |

#### Content Format Breakdown
- Guides: 5
- Listicles: 3
- Tools: 1
- Videos: 1

#### Key Insights
- **Winning Format:** [The format that dominates top results]
- **Content Depth:** [Average depth/length of ranking content]
- **Common Sections:** [Sections appearing in most top content]
- **Featured Snippet Opportunity:** [Yes/No - what format works]
- **Differentiation Angle:** [How to create better content]

#### Recommended Content Approach
[Specific recommendations for content to rank for this keyword]

---

### [Additional keywords...]

## Cross-Keyword Insights

### Featured Snippet Opportunities
[Keywords where featured snippets are present and capturable]

| Keyword | Current Snippet Type | Current Holder | Opportunity Rating | Recommended Format |
|---------|---------------------|----------------|-------------------|-------------------|

### Content Format Recommendations by Intent

#### Informational Keywords
- Primary format: [Long-form guides]
- Average length: [2000-3000 words]
- Key sections to include: [List]

#### Commercial Keywords
- Primary format: [Comparison articles, reviews]
- Average length: [1500-2500 words]
- Key sections to include: [List]

#### Transactional Keywords
- Primary format: [Landing pages with clear CTAs]
- Average length: [800-1500 words]
- Key elements to include: [List]

### SERP Feature Capture Strategies

#### Featured Snippets
[How to optimize for featured snippet capture]

#### People Also Ask (PAA)
[PAA questions to address in content]

#### Video Results
[Video content opportunities]

## Competitor Ranking Patterns
[Which competitors rank most frequently and why]

## SERP Volatility Notes
[Any recent changes or volatility observed]
```

**Output Location:** `/analysis/serp-analysis-{DATE}.md`

**Dependencies:** None (standalone analysis)

**Parallel Opportunities:** Often feeds into content-brief-creator

**Model Recommendation:** Sonnet (analytical work with web search)

**Color:** Magenta (search intelligence)

---

### 🆕 20. site-architecture-analyst

**Purpose:** Review and recommend site structure improvements for better crawlability and UX

**When to Trigger:**
- "Optimize site structure"
- "Improve site architecture"
- Technical SEO audit
- Site redesign or migration
- Scalability concerns

**Primary Responsibilities:**
- Analyze current site structure and information architecture
- Evaluate navigation and user experience
- Assess URL structure and hierarchy
- Identify crawl depth and orphan page issues
- Recommend category and taxonomy improvements
- Design topic cluster architecture
- Evaluate pagination and faceted navigation
- Optimize for crawl efficiency
- Align structure with user journey and business goals

**Input Requirements:**
- Website URL (required)
- Site crawl data (required)
- Business goals and priority pages (optional)
- User journey insights (optional)

**Output Format:**
```markdown
# Site Architecture Analysis

**Website:** [URL]
**Date:** [DATE]
**Pages Analyzed:** [NUMBER]

## Current Architecture Assessment

### Structure Overview
- Homepage depth levels: [NUMBER]
- Average click depth to reach content: [NUMBER]
- Navigation structure: [Horizontal/Vertical/Mixed]
- Primary navigation items: [NUMBER]

### Issues Identified
- Orphan pages: [NUMBER]
- Pages beyond 3-click depth: [NUMBER]
- Broken internal links: [NUMBER]
- Confusing navigation paths: [LIST]

## URL Structure Analysis

### Current URL Patterns
```
Homepage: /
Category: /category-name/
Subcategory: /category-name/subcategory-name/
Content: /category-name/subcategory-name/page-name/
```

### URL Structure Issues
- Overly deep URLs: [EXAMPLES]
- Inconsistent patterns: [EXAMPLES]
- Non-descriptive URLs: [EXAMPLES]

### Recommended URL Structure
```
[Improved structure with rationale]
```

## Recommended Site Architecture

### Visual Site Map
```
Homepage
├─ Primary Category 1
│  ├─ Subcategory 1.1
│  │  └─ Content pages
│  └─ Subcategory 1.2
├─ Primary Category 2
│  ├─ Subcategory 2.1
│  └─ Subcategory 2.2
└─ Primary Category 3
```

### Navigation Optimization

#### Primary Navigation
[Recommended main navigation structure]

#### Secondary Navigation
[Breadcrumbs, footer, sidebar recommendations]

#### Internal Search
[Recommendations for internal search functionality]

## Topic Cluster Architecture

### Pillar Content Strategy
[How to organize content into pillar and cluster model]

#### Pillar 1: [TOPIC]
- Pillar page: [URL]
- Supporting cluster pages: [URLs]
- Internal linking strategy: [Approach]

### [Additional pillars...]

## Category & Taxonomy Recommendations
[How to organize products/content categories]

## Pagination Strategy
[How to handle paginated content for SEO]

## Faceted Navigation Recommendations
[For e-commerce: how to handle filters without duplicate content]

## Priority Page Accessibility
[Ensuring important pages are easily accessible]

### Pages Needing Better Accessibility
| Page | Current Depth | Importance | Recommended Depth | Action |
|------|--------------|------------|------------------|--------|

## Implementation Roadmap

### Phase 1: Quick Fixes (0-4 weeks)
- [ ] Fix orphan pages
- [ ] Simplify primary navigation
- [ ] Add breadcrumbs

### Phase 2: Structural Improvements (1-3 months)
- [ ] Implement URL structure changes with redirects
- [ ] Build pillar content architecture
- [ ] Optimize internal linking

### Phase 3: Advanced Optimization (3-6 months)
- [ ] Full category restructure (if needed)
- [ ] Advanced faceted navigation setup
- [ ] Complete topic cluster implementation

## Migration Considerations
[If restructure requires URL changes, redirect mapping approach]

## Expected Impact
- Improved crawl efficiency: [ESTIMATE]
- Better user navigation: [METRICS]
- Enhanced authority distribution: [DESCRIPTION]
```

**Output Location:** `/analysis/site-architecture-analysis-{DATE}.md`

**Dependencies:**
- technical-seo-auditor (complementary analysis)

**Parallel Opportunities:** Often informs internal-linking-strategist work

**Model Recommendation:** Sonnet (architectural analysis)

**Color:** Blue (structure)

---

### 🆕 21. local-seo-strategist

**Purpose:** Create local SEO strategies for businesses with physical locations

**When to Trigger:**
- "Optimize for local search"
- "Local SEO strategy"
- Business has physical location(s)
- Multi-location SEO needs
- Local ranking concerns

**Primary Responsibilities:**
- Develop Google Business Profile optimization strategy
- Plan local citation building
- Create local keyword targeting approach
- Recommend local content strategies
- Design review generation and management plan
- Develop multi-location SEO approach (if applicable)
- Recommend local link building tactics
- Optimize for "near me" searches
- Plan location page structure

**Input Requirements:**
- Business profile with location(s) (required)
- Service area information (required)
- Current local SEO state (optional)
- Competitor local presence (optional)

**Output Format:**
```markdown
# Local SEO Strategy

**Business:** [BUSINESS NAME]
**Date:** [DATE]
**Location(s):** [NUMBER] locations

## Local SEO Current State
- GBP listing status: [Complete/Incomplete/Not claimed]
- NAP consistency: [Consistent/Inconsistent]
- Citation count: [NUMBER]
- Review count: [NUMBER]
- Average rating: [X.X stars]
- Local pack rankings: [Top keywords and positions]

## Google Business Profile Optimization

### GBP Completeness Checklist
- [ ] Business name (consistent with website)
- [ ] Complete address
- [ ] Phone number (local number preferred)
- [ ] Website URL
- [ ] Business hours (including special hours)
- [ ] Business categories (primary + secondary)
- [ ] Business description (750 char limit, keyword-optimized)
- [ ] Photos (minimum 10 high-quality photos)
- [ ] Logo
- [ ] Cover photo
- [ ] Services list
- [ ] Products (if applicable)
- [ ] Attributes (wheelchair accessible, etc.)
- [ ] Q&A section populated

### GBP Content Strategy
- **Posts Frequency:** [Recommendation]
- **Post Types:** Updates, offers, events, products
- **Photo Upload Strategy:** [Schedule and types]

## Local Keyword Strategy

### Location-Modified Keywords
[Keywords with geographic modifiers]

| Keyword | Modifier Type | Priority | Current Ranking | Target |
|---------|--------------|----------|----------------|--------|
| [service] [city] | City | High | Not ranking | Top 3 |
| [service] near me | Proximity | High | #12 | Top 3 |

### Service Area Keywords
[Keywords for surrounding areas beyond primary location]

### Competitor Local Keywords
[Local keywords competitors rank for]

## Citation Building Strategy

### Priority Citation Sources (Do First)
1. Google Business Profile
2. Bing Places
3. Apple Maps
4. Facebook
5. Yelp
6. [Industry-specific directories]

### NAP Consistency Guidelines
**Name:** [Exact business name]
**Address:** [Format to use consistently]
**Phone:** [Format to use consistently]

### Citation Audit
- Existing citations: [NUMBER]
- Inconsistent citations to fix: [NUMBER]
- Missing citations: [NUMBER]

### Citation Building Roadmap
[Month-by-month citation targets]

## Review Management Strategy

### Current Review Profile
- Total reviews: [NUMBER]
- Average rating: [X.X]
- Response rate: [X%]
- Review velocity: [X per month]

### Review Generation Plan
- **Target:** [X reviews per month]
- **Methods:**
  - Post-service email requests
  - In-person requests (with signage/cards)
  - Follow-up SMS
  - Review link on website
- **Timing:** Ask within [X] days of service

### Review Response Protocol
- Positive reviews: [Response approach]
- Negative reviews: [Response protocol]
- Response time target: [X hours/days]

## Local Content Strategy

### Location Pages
[Structure and content for location-specific pages]

#### Page Template:
- Location name + business name (H1)
- Embedded Google Map
- NAP information
- Unique location description
- Location-specific services
- Location-specific testimonials
- Location-specific photos
- Driving directions
- Parking information
- Local area information
- Schema markup (LocalBusiness)

### Local Content Topics
[Blog posts and content targeting local audiences]
- Local events and participation
- Local partnerships
- Community involvement
- Local industry insights
- Local customer stories

## Multi-Location Strategy (if applicable)

### Location Page Architecture
```
/locations/ (main location page)
├─ /locations/[city-1]/
├─ /locations/[city-2]/
└─ /locations/[city-3]/
```

### Individual GBP Management
[Strategy for managing multiple profiles]

### Local Link Building per Location
[Location-specific link opportunities]

## Local Link Building

### Local Link Opportunities
- Local business associations
- Chamber of Commerce
- Local news and media
- Community event sponsorships
- Local supplier and partner sites
- Local bloggers and influencers
- University/school partnerships
- Local charity and nonprofit involvement

### Priority Local Links
| Opportunity | Type | DA | Status | Next Step |
|------------|------|----|---------||----------|

## Schema Markup for Local SEO
- LocalBusiness schema
- GeoCoordinates
- OpeningHours
- Address (PostalAddress)
- AggregateRating (if reviews)

## Implementation Timeline

### Month 1: Foundation
- [ ] Claim and optimize GBP
- [ ] Ensure NAP consistency across website
- [ ] Submit to top 10 citation sources
- [ ] Implement LocalBusiness schema

### Month 2: Expansion
- [ ] Complete citation building (30+ citations)
- [ ] Launch review generation campaign
- [ ] Create/optimize location pages
- [ ] Begin local content creation

### Month 3: Growth
- [ ] Local link building outreach
- [ ] Expand review generation
- [ ] Regular GBP posts and updates
- [ ] Monitor local pack rankings

## Metrics to Track
- Local pack rankings for target keywords
- GBP insights (views, actions)
- Review count and rating
- Website traffic from local search
- Citation count and consistency
- Local organic rankings

## Expected Results
- Timeline to see results: [X months]
- Target local pack positions: Top 3 for [X] keywords
- Target review count: [NUMBER] in [TIMEFRAME]
```

**Output Location:** `/analysis/local-seo-strategy-{DATE}.md`

**Dependencies:**
- business-profile-creator (requires business context)

**Parallel Opportunities:** Can run standalone for local businesses

**Model Recommendation:** Sonnet (strategic planning)

**Color:** Green (local/growth)

---

### 🆕 22. url-structure-optimizer

**Purpose:** Analyze and recommend URL structure improvements

**When to Trigger:**
- "Optimize URL structure"
- Site migration planning
- URL restructure project
- Poor URL patterns identified in audit
- New site section planning

**Primary Responsibilities:**
- Audit current URL structure and patterns
- Identify non-SEO-friendly URLs
- Recommend optimized URL patterns by page type
- Ensure keyword inclusion where appropriate
- Simplify overly complex URLs
- Design URL structure for scalability
- Create redirect mapping for URL changes
- Align URLs with site architecture
- Consider international/multilingual URL structure

**Input Requirements:**
- Website URL or URL list (required)
- Site architecture (required)
- Target keywords by page (helpful)
- International/multilingual considerations (if applicable)

**Output Format:**
```markdown
# URL Structure Optimization

**Website:** [URL]
**Date:** [DATE]
**URLs Analyzed:** [NUMBER]

## Current URL Structure Assessment

### URL Patterns by Page Type

#### Homepage
- Current: [Example URL]
- Assessment: [Issues or good]

#### Category Pages
- Pattern: [Example pattern]
- Assessment: [Issues]

#### Product/Service Pages
- Pattern: [Example pattern]
- Assessment: [Issues]

#### Blog Posts
- Pattern: [Example pattern]
- Assessment: [Issues]

### Issues Identified
- URLs with session IDs or parameters: [NUMBER]
- Overly long URLs (>75 chars): [NUMBER]
- Non-descriptive URLs: [NUMBER]
- Inconsistent patterns: [Examples]
- URLs with underscores instead of hyphens: [NUMBER]
- URLs with uppercase characters: [NUMBER]
- URLs with stop words: [NUMBER]

## Recommended URL Structure

### URL Best Practices Applied
- Use hyphens (not underscores) to separate words
- Keep URLs short and descriptive (under 60 chars ideal)
- Use lowercase only
- Include target keyword when natural
- Maintain consistent patterns
- Minimize subfolder depth
- Avoid unnecessary parameters

### Recommended Patterns by Page Type

#### Homepage
```
Recommended: https://example.com/
```

#### Category Pages
```
Current:  https://example.com/product.php?cat=electronics
Recommended: https://example.com/electronics/
Rationale: Cleaner, keyword-rich, more user-friendly
```

#### Subcategory Pages
```
Current: https://example.com/products/electronics/computers/laptops/
Recommended: https://example.com/laptops/
Rationale: Reduce depth, improve usability
```

#### Product Pages
```
Current: https://example.com/product.php?id=12345
Recommended: https://example.com/products/macbook-pro-16-inch/
Rationale: Descriptive, includes product identifier
```

#### Blog Posts
```
Current: https://example.com/blog/2024/03/15/post-title-here/
Recommended: https://example.com/blog/post-title-here/
Rationale: Remove date from URL for evergreen content
```

#### Service Pages
```
Recommended: https://example.com/services/[service-name]/
```

#### Location Pages (if applicable)
```
Recommended: https://example.com/locations/[city-name]/
```

## URL Migration Plan

### URLs Requiring Changes: [NUMBER]

#### Priority 1: High-Traffic Pages
| Current URL | New URL | Traffic | Redirect Type | Priority |
|------------|---------|---------|--------------|----------|
| [Old URL] | [New URL] | [Monthly visits] | 301 | High |

#### Priority 2: Important SEO Pages
[Pages ranking for target keywords]

#### Priority 3: Remaining Pages
[Bulk URL changes]

### Redirect Mapping
[Complete current URL → new URL mapping]

### Implementation Steps
1. Create comprehensive redirect map (CSV)
2. Implement 301 redirects (via .htaccess, nginx config, or CMS)
3. Update internal links to new URLs
4. Update XML sitemap
5. Test all redirects
6. Monitor Search Console for errors
7. Update backlinks where possible (high-value links)

## URL Parameter Handling

### Parameters to Remove
[Tracking parameters, session IDs to clean up]

### Parameters to Keep (with proper handling)
[Necessary parameters like pagination, filtering]

### Canonical Tag Strategy
[How to handle URL parameters with canonical tags]

## International/Multilingual URL Structure (if applicable)

### Options
1. **ccTLD:** example.de, example.fr
2. **Subdomain:** de.example.com, fr.example.com
3. **Subdirectory:** example.com/de/, example.com/fr/ (RECOMMENDED)
4. **Parameter:** example.com?lang=de (NOT RECOMMENDED)

### Recommended Approach
[Specific recommendation with rationale]

## Special Considerations

### Pagination URLs
```
Recommended: https://example.com/category/page/2/
Avoid: https://example.com/category/?page=2
```

### Filtered/Faceted URLs (E-commerce)
[Strategy for handling filtered product pages]

### Mobile URLs
- Recommendation: Responsive design (no separate mobile URLs)
- If separate mobile site: Use m.example.com with proper mobile annotations

## Testing and Validation

### Pre-Launch Checklist
- [ ] All redirects tested in staging
- [ ] No redirect chains
- [ ] No redirect loops
- [ ] All internal links updated
- [ ] XML sitemap updated
- [ ] Robot.txt reviewed
- [ ] Canonical tags verified
- [ ] 404 page ready

### Post-Launch Monitoring
- Monitor Search Console for crawl errors
- Track 301 redirects in log files
- Monitor rankings for migrated pages
- Track traffic impact

## Expected Impact
- Improved user experience: [Description]
- Better click-through rates: [Estimate]
- Enhanced crawlability: [Description]
- Improved keyword targeting: [Examples]

## Timeline
- Planning & mapping: [X weeks]
- Implementation: [X weeks]
- Monitoring period: [X weeks]
```

**Output Location:** `/deliverables/url-structure-optimization-{DATE}.md`

**Dependencies:**
- site-architecture-analyst (complementary work)
- keyword-strategist (for keyword inclusion in URLs)

**Parallel Opportunities:** Often part of larger site migration or technical SEO project

**Model Recommendation:** Sonnet (technical planning)

**Color:** Blue (structure)

---

### 🆕 23. semantic-content-analyzer

**Purpose:** Analyze content for semantic SEO and topical authority depth

**When to Trigger:**
- "Improve topical authority"
- "Add semantic depth to content"
- Content underperforming despite keywords
- Comprehensive content optimization
- Building authority in specific topics

**Primary Responsibilities:**
- Analyze content for semantic relevance and depth
- Identify missing related terms and concepts (LSI keywords)
- Assess topical authority coverage
- Compare semantic depth vs. competitors
- Recommend related terms to include
- Identify topic gaps in content clusters
- Evaluate entity coverage and relationships
- Suggest semantic content enhancements
- Assess content comprehensiveness

**Input Requirements:**
- Target content URL or text (required)
- Target topic/keywords (required)
- Competitor content (optional but helpful)
- Existing topic cluster context (optional)

**Output Format:**
```markdown
# Semantic Content Analysis

**URL:** [URL]
**Date:** [DATE]
**Primary Topic:** [TOPIC]
**Target Keywords:** [LIST]

## Content Overview
- Word count: [NUMBER]
- Main topic coverage: [Assessment]
- Semantic depth score: [X/10]
- Topical authority: [Strong/Moderate/Weak]

## Semantic Analysis

### Core Entities Present
[Key entities (people, places, things, concepts) mentioned in content]
- Entity 1: Mentioned [X] times
- Entity 2: Mentioned [X] times

### Core Entities Missing
[Important entities related to topic not covered]
- [Entity]: Relevance [High/Medium/Low]
- [Entity]: Relevance [High/Medium/Low]

### Related Terms and Concepts

#### Terms Well-Covered
[Related terms that are appropriately included]

#### Missing Related Terms (High Priority)
[Terms that should be included for semantic completeness]

| Term/Concept | Relevance | Current Mentions | Recommended Mentions | Where to Add |
|--------------|-----------|------------------|---------------------|--------------|
| [Term] | High | 0 | 3-5 | [Section] |

#### Missing Related Terms (Medium Priority)
[Additional terms that would enhance semantic depth]

### Semantic Gaps vs. Top-Ranking Content

#### What Competitors Cover That This Content Doesn't
- [Topic/subtopic]: Covered by [Competitor 1, 2]
- [Topic/subtopic]: Covered by [Competitor 1]

### Topic Cluster Context

#### Current Content in This Cluster
[Related content pieces on similar topics]

#### Coverage Gaps in Cluster
[Subtopics that need dedicated content]

### Entity Relationships

#### Entities Properly Connected
[Entities with good relationship context]

#### Entity Connections to Strengthen
[Entities mentioned but not properly connected to main topic]

## Content Depth Assessment

### Sections Well-Developed
- [Section name]: [Assessment]

### Sections Needing Expansion
- [Section name]: [Current word count] → [Recommended word count]
  - Missing concepts: [List]
  - Recommended additions: [Specific content]

### Missing Sections/Subsections
[Sections that should be added]
- [Section name]: [Why it's needed]

## Semantic Optimization Recommendations

### Priority 1: Essential Additions (Implement Immediately)
1. **Add section on [Topic]**
   - Location: After [existing section]
   - Length: [X words]
   - Key terms to include: [List]
   - Why: [Rationale]

2. **Enhance [Section] with [Concepts]**
   - Add [X] paragraphs covering [specific aspects]
   - Include terms: [List]

### Priority 2: Moderate Enhancements
[Additional improvements for comprehensive coverage]

### Priority 3: Nice-to-Have Additions
[Further depth for exceptional topical authority]

## Semantic Keyword Integration

### Natural Integration Points
[Where to add semantic keywords without keyword stuffing]

| Semantic Term | Current Usage | Target Usage | Suggested Locations |
|---------------|--------------|--------------|-------------------|

## Entity Schema Recommendations
[Structured data opportunities to mark up entities]

## Internal Linking Opportunities for Semantic SEO
[Links to related content that strengthen topical authority]

## Content Comprehensiveness Score

### Compared to Top 3 Competitors
- **Your content:** [Score/100]
- **Competitor 1:** [Score/100]
- **Competitor 2:** [Score/100]
- **Competitor 3:** [Score/100]

### Areas Where Your Content Excels
[Aspects where your content is more comprehensive]

### Areas for Improvement
[Where competitors have better coverage]

## Implementation Checklist
- [ ] Add missing high-priority entities
- [ ] Expand under-developed sections
- [ ] Include missing related terms
- [ ] Add new sections for topic gaps
- [ ] Strengthen entity relationships
- [ ] Add entity schema markup
- [ ] Add internal links to related cluster content
- [ ] Review overall semantic flow and cohesion

## Expected Impact
- Improved semantic relevance: [Description]
- Better topical authority: [Description]
- Enhanced rankings for: [Keywords]
- Potential to rank for: [Additional long-tail keywords]
```

**Output Location:** `/analysis/semantic-content-analysis-{URL-slug}-{DATE}.md`

**Dependencies:**
- serp-analyzer (for competitor comparison)
- keyword-strategist (for semantic keyword context)

**Parallel Opportunities:** Can analyze multiple pieces in parallel

**Model Recommendation:** Opus (deep semantic understanding benefits from highest capability)

**Color:** Indigo (advanced content optimization)

---

### 🆕 24. conversion-optimizer

**Purpose:** Analyze and optimize landing pages for conversion rate from SEO traffic

**When to Trigger:**
- "Improve conversion rate"
- "Optimize landing pages"
- Good traffic but low conversions
- CRO for organic traffic
- New landing page creation

**Primary Responsibilities:**
- Analyze landing page conversion performance
- Identify conversion barriers and friction points
- Assess CTA effectiveness
- Evaluate page layout and user experience
- Recommend A/B test hypotheses
- Optimize forms and conversion paths
- Ensure message match with search intent
- Analyze user behavior patterns
- Recommend page structure improvements
- Consider mobile conversion experience

**Input Requirements:**
- Landing page URL(s) (required)
- Conversion goals (required)
- Traffic source (organic search) (required)
- User behavior data (analytics, heatmaps) (optional but helpful)
- Current conversion rate (optional)

**Output Format:**
```markdown
# Conversion Optimization Report

**Page(s) Analyzed:** [URL(s)]
**Date:** [DATE]
**Conversion Goal:** [Goal description]
**Current Conversion Rate:** [X%]

## Performance Summary
- Page traffic (organic): [Monthly visitors]
- Current conversions: [NUMBER per month]
- Conversion rate: [X%]
- Bounce rate: [X%]
- Average time on page: [X minutes]
- Mobile vs. desktop conversion: [Comparison]

## Conversion Audit

### Above the Fold Analysis
- **Headline:** [Assessment]
- **Value Proposition Clarity:** [Strong/Moderate/Weak]
- **Primary CTA Visibility:** [Assessment]
- **Visual Hierarchy:** [Assessment]
- **Mobile Experience:** [Assessment]

### Message Match Assessment
- **Search Intent:** [Intent type]
- **Landing Page Message:** [Assessment of match]
- **Message Match Score:** [X/10]
- **Issues:** [If message doesn't align with search intent]

### Conversion Path Analysis
- **Steps to conversion:** [NUMBER]
- **Friction points:** [List]
- **Path clarity:** [Clear/Confusing]

## Issues Identified

### Critical Issues (Immediate Impact)

#### 1. [Issue Name]
**Impact:** High
**Current State:** [Description]
**Effect on Conversions:** [Specific impact]

**Problem:**
[Detailed description]

**Solution:**
[Specific recommendation]

**Expected Lift:** [Estimated improvement]

### High-Priority Issues
[Important but not critical]

### Medium-Priority Issues
[Lower immediate impact]

## CTA (Call-to-Action) Optimization

### Current CTA Analysis
- **Primary CTA Text:** "[Current text]"
- **CTA Design:** [Button/link] - [Color] - [Size]
- **CTA Placement:** [Locations on page]
- **CTA Visibility:** [Assessment]

### CTA Recommendations

#### Primary CTA
- **Recommended Text:** "[New text]" (more action-oriented, value-focused)
- **Design:** [Specific design recommendations]
- **Placement:** [Where to position]
- **A/B Test Variants:**
  - Variant A: "[CTA text]"
  - Variant B: "[CTA text]"
  - Variant C: "[CTA text]"

#### Secondary CTA (if applicable)
[Recommendations for secondary conversion path]

### CTA Frequency
- Current: [X] CTAs on page
- Recommended: [X] CTAs (with placement rationale)

## Page Structure Optimization

### Content Layout Recommendations

#### Recommended Page Structure
1. **Hero Section**
   - Compelling headline addressing search intent
   - Clear value proposition (one sentence)
   - Primary CTA
   - Trust signal (logo, rating, etc.)
   - Hero image/video

2. **Benefits Section**
   - 3-5 key benefits (not features)
   - Icons or visuals
   - Scannable format

3. **Social Proof**
   - Customer testimonials
   - Case studies or results
   - Trust badges
   - Customer logos (if B2B)

4. **Features/Details** (if needed)
   - Detailed information for consideration stage
   - Comparison table (if applicable)

5. **FAQ or Objection Handling**
   - Address common questions
   - Reduce friction

6. **Final CTA Section**
   - Restate value proposition
   - Strong CTA
   - Risk reversal (guarantee, free trial, etc.)

### Content Improvements
[Specific content recommendations]

## Form Optimization (if applicable)

### Current Form Analysis
- Fields: [NUMBER]
- Required vs. optional: [Breakdown]
- Completion rate: [X%]

### Form Recommendations
- **Reduce fields to:** [NUMBER] (remove: [specific fields])
- **Field order:** [Recommended sequence]
- **Progressive disclosure:** [If applicable]
- **Error handling:** [Improvements]
- **Submit button text:** "[Recommended text]" (not generic "Submit")

### Multi-Step Form Consideration
[If current form is long, consider multi-step with progress indicator]

## Trust and Credibility Enhancements

### Current Trust Signals
[What's present: testimonials, badges, guarantees, etc.]

### Recommended Trust Elements
- [ ] Customer testimonials (with photos and names)
- [ ] Star ratings/reviews
- [ ] Trust badges (security, money-back guarantee)
- [ ] Customer logos (if B2B)
- [ ] Case studies or results
- [ ] Industry certifications or awards
- [ ] "As seen in" media logos
- [ ] Number of customers/users
- [ ] Real-time social proof (if applicable)

## Visual Hierarchy Improvements
- **Headline:** [Font size, weight, color recommendations]
- **Subheadlines:** [Formatting]
- **Body copy:** [Readability improvements]
- **CTAs:** [Visual prominence]
- **Whitespace:** [Recommendations]

## Mobile Optimization

### Mobile-Specific Issues
- CTA button size: [Assessment]
- Form usability on mobile: [Assessment]
- Page load speed on mobile: [Assessment]
- Text readability: [Assessment]

### Mobile CRO Recommendations
[Specific mobile improvements]

## Page Speed Impact on Conversion
- Current load time: [X seconds]
- Recommended: <2 seconds
- Impact: [For every 1-second delay, conversion drops X%]
- **Recommendation:** [If speed issues, reference page-speed-analyst]

## Personalization Opportunities
[If applicable, dynamic content based on traffic source, returning visitors, etc.]

## A/B Test Roadmap

### Priority 1 Tests (Run First)
1. **Test Name:** [Descriptive name]
   - **Hypothesis:** [What we believe and why]
   - **Variants:**
     - Control: [Current state]
     - Variant A: [Change]
     - Variant B: [Change]
   - **Success Metric:** [Conversion rate, form submissions, etc.]
   - **Estimated Impact:** [X% improvement]
   - **Sample Size Needed:** [Visits per variant]
   - **Test Duration:** [Days]

### Priority 2 Tests
[Additional tests after priority 1 validates]

### Priority 3 Tests
[Further optimization tests]

## Quick Wins (Implement Without Testing)

[Changes with proven effectiveness that don't require testing]
1. [Specific change]
2. [Specific change]
3. [Specific change]

## Implementation Priority

### Immediate (This Week)
- [ ] [Action item]
- [ ] [Action item]

### Short-Term (This Month)
- [ ] [Action item]
- [ ] [Action item]

### Ongoing Optimization
- [ ] [Action item]
- [ ] [Action item]

## Expected Impact

### Conservative Estimate
- Conversion rate improvement: [X%]
- Additional conversions per month: [NUMBER]
- Revenue impact (if known): [$X]

### Optimistic Estimate
- Conversion rate improvement: [X%]
- Additional conversions per month: [NUMBER]
- Revenue impact (if known): [$X]

## Tracking and Measurement

### Conversion Tracking Setup
[Ensure proper tracking is in place]

### Metrics to Monitor
- Conversion rate (overall and by device)
- Bounce rate
- Time on page
- Scroll depth
- Form abandonment rate
- CTA click-through rate

### Reporting Cadence
- Weekly: [Metrics]
- Monthly: [Comprehensive review]
```

**Output Location:** `/analysis/conversion-optimization-{page-slug}-{DATE}.md`

**Dependencies:** None (standalone analysis)

**Parallel Opportunities:** Can analyze multiple landing pages in parallel

**Model Recommendation:** Sonnet (conversion analysis and recommendations)

**Color:** Gold (revenue/conversion focus)

---

## Agent Interaction Patterns

### Sequential Workflows (Dependencies)

**Competitive Analysis Flow:**
```
competitor-identifier → competitive-landscape-analyzer → keyword-gap-analyzer
                                                        → content-gap-analyzer
                                                        → backlink-analyzer
```

**Keyword to Content Flow:**
```
keyword-researcher → keyword-strategist → content-brief-creator → content-writer → content-editor
```

**Technical SEO Flow:**
```
technical-seo-auditor → site-architecture-analyst → internal-linking-strategist
                      → page-speed-analyst
                      → schema-strategist
```

### Parallel Execution Opportunities

**After Business Profile:**
```
[business-profile-creator completes]
    ├─ competitor-identifier
    ├─ brand-style-guide-researcher
    └─ keyword-researcher
```

**After Competitor Identification:**
```
[competitor-identifier completes]
    ├─ competitive-landscape-analyzer
    ├─ keyword-researcher (competitor focus)
    ├─ backlink-analyzer (competitor focus)
    └─ content-gap-analyzer
```

**Independent Parallel Analysis:**
```
[Website URL provided]
    ├─ technical-seo-auditor
    ├─ backlink-analyzer
    ├─ content-refresh-prioritizer
    └─ page-speed-analyst
```

---

## Implementation Priority

### Phase 1: Core Agents (Highest Impact)
1. ✅ business-profile-creator (COMPLETE)
2. ✅ competitor-identifier (COMPLETE)
3. ✅ keyword-researcher (COMPLETE)
4. 🆕 keyword-strategist (IMPLEMENT NEXT)
5. 🆕 content-brief-creator (IMPLEMENT NEXT)
6. 🆕 technical-seo-auditor (IMPLEMENT NEXT)

### Phase 2: Strategic Agents
7. 🆕 keyword-gap-analyzer
8. 🆕 content-gap-analyzer
9. 🆕 serp-analyzer
10. 🆕 content-refresh-prioritizer

### Phase 3: Technical & Optimization Agents
11. 🆕 site-architecture-analyst
12. 🆕 internal-linking-strategist
13. 🆕 meta-optimizer
14. 🆕 schema-strategist
15. 🆕 page-speed-analyst

### Phase 4: Specialized Agents
16. 🆕 backlink-analyzer
17. 🆕 local-seo-strategist
18. 🆕 url-structure-optimizer
19. 🆕 semantic-content-analyzer
20. 🆕 conversion-optimizer

---

## Agent File Storage Reference

| Agent | Output Location Pattern |
|-------|------------------------|
| business-profile-creator | `/context/business-profile.md` |
| competitor-identifier | `/context/competitors.md` |
| competitive-landscape-analyzer | `/analysis/competitive-landscape-{DATE}.md` |
| keyword-researcher | `/analysis/keyword-research-{TOPIC}-{DATE}.md` |
| brand-style-guide-researcher | `/context/style-guide.md` |
| content-writer | `/deliverables/content/{type}-{topic}-{DATE}.md` |
| content-editor | Updates files in place or versioned |
| technical-seo-auditor | `/analysis/technical-seo-audit-{DATE}.md` |
| keyword-strategist | `/analysis/keyword-strategy-{DATE}.md` |
| keyword-gap-analyzer | `/analysis/keyword-gap-analysis-{DATE}.md` |
| content-gap-analyzer | `/analysis/content-gap-analysis-{DATE}.md` |
| content-brief-creator | `/deliverables/content-briefs/brief-{topic}-{DATE}.md` |
| internal-linking-strategist | `/analysis/internal-linking-strategy-{DATE}.md` |
| meta-optimizer | `/deliverables/meta-optimization-{DATE}.md` |
| schema-strategist | `/deliverables/schema-strategy-{DATE}.md` |
| backlink-analyzer | `/analysis/backlink-analysis-{DATE}.md` |
| page-speed-analyst | `/analysis/page-speed-analysis-{DATE}.md` |
| content-refresh-prioritizer | `/analysis/content-refresh-priorities-{DATE}.md` |
| serp-analyzer | `/analysis/serp-analysis-{DATE}.md` |
| site-architecture-analyst | `/analysis/site-architecture-analysis-{DATE}.md` |
| local-seo-strategist | `/analysis/local-seo-strategy-{DATE}.md` |
| url-structure-optimizer | `/deliverables/url-structure-optimization-{DATE}.md` |
| semantic-content-analyzer | `/analysis/semantic-content-analysis-{slug}-{DATE}.md` |
| conversion-optimizer | `/analysis/conversion-optimization-{page-slug}-{DATE}.md` |

---

## Model Selection Guidelines

- **Opus:** Content creation requiring highest quality, deep semantic understanding (content-writer, semantic-content-analyzer)
- **Sonnet:** Most analytical work, strategic planning, technical audits (default for most agents)
- **Haiku:** Not recommended for these complex analytical tasks

---

## Next Steps for Implementation

1. **Review and Validate:** User reviews this roadmap for completeness and alignment
2. **Prioritize Implementation:** Determine which new agents to build first based on business needs
3. **Create Agent Definitions:** Build out the .md files for each new agent following existing patterns
4. **Update Orchestrator:** Update main CLAUDE.md with new agent descriptions and trigger conditions
5. **Test Workflows:** Test multi-agent workflows and parallel execution
6. **Iterate:** Refine agent prompts based on real-world usage and outputs

---

**Document Status:** Complete specification ready for implementation
**Total Agents Specified:** 24 (7 existing + 17 new)
**Estimated Implementation Time:** 4-6 weeks for all new agents
**Priority Focus:** Core agents (Phase 1) in first 2 weeks