Strategy Writer

interface StrategyWriterInput {
  tenantId: string;
  approvedContextFile: string;      // Full Markdown of the approved Client Context File
  businessGoals: string[];          // Tenant-specified goals from onboarding (e.g. ["Increase local leads by 30%", "Build brand awareness in Ipswich"])
  currentChannels: string[];        // Connected OAuth channels (e.g. ["google_search_console", "google_ads", "facebook_pages"])
  planType: 'free' | 'pro' | 'agency' | 'enterprise';
  refreshMode?: boolean;            // true = updating existing strategy
  existingStrategy?: string;        // Previous strategy Markdown — only if refreshMode = true
}

interface StrategyWriterOutput {
  tenantId: string;
  generatedAt: string;              // ISO 8601 timestamp
  strategyMarkdown: string;         // Full Markdown strategy document
  smartGoals: SmartGoal[];          // Extracted/structured form of the goals section
  recommendedChannels: string[];    // Channel slugs recommended (subset of available channels on their plan)
  wordCount: number;
  changesSummary?: string;          // Only on refresh runs
}
 
interface SmartGoal {
  goal: string;                     // One sentence
  metric: string;                   // How it will be measured
  target: string;                   // Specific number or threshold
  timeframe: string;                // e.g. "Within 6 months"
  channel?: string;                 // Primary channel this goal relates to
}

# Marketing Strategy — Clearflow Plumbing
 
_Generated: March 2026 | Plan: Pro | Prepared by: Leadmetrics v3_
 
---
 
## Executive Summary
 
Clearflow Plumbing enters the next 12 months with a clear competitive advantage — transparent, published pricing — that no direct competitor has capitalised on in content or SEO. The strategy is built around three pillars: (1) owning the high-intent local search queries that competitors underserve, (2) establishing Clearflow as Brisbane's most trustworthy plumbing resource through educational content, and (3) converting organic traffic into booked jobs through a consistent Google Business Profile presence.
 
---
 
## Market Position
 
Clearflow operates in a high-trust-deficit category. Homeowners searching for a plumber are primarily motivated by anxiety — fear of being overcharged, stood up, or misled. No competitor directly addresses this anxiety in their content. Clearflow's pricing transparency is not just a differentiator; it is a direct response to the market's number-one objection.
 
**Position to own:** "The plumber who shows you the price before they show up."
 
---
 
## Goals (SMART)
 
| Goal | Metric | Target | Timeframe |
|---|---|---|---|
| Grow organic search traffic | Google Search Console impressions | +40% | 6 months |
| Increase booked jobs from website | Google Analytics goal completions | +25 enquiries/month | 3 months |
| Build GBP authority in Ipswich | Google Business Profile views | 500 views/month | 4 months |
| Establish content authority | Blog posts ranking on page 1 | 5 posts | 6 months |
 
---
 
## Recommended Channels
 
Given the Pro plan and connected channels, the recommended priority order is:
 
1. **SEO + Blog** — Highest ROI for a local service business with a pricing transparency story. Target informational and commercial-investigation queries.
2. **Google Business Profile** — Critical for local pack rankings. Weekly posts, review responses, Q&A management.
3. **Google Ads** — Defensive spend on branded keywords and high-intent emergency queries (blocked drain, burst pipe).
4. **Facebook** — Secondary; supports retargeting and community trust-building. Not the primary lead channel.
 
---
 
## Competitive Advantage
 
Three things Clearflow can do in content that no current competitor does:
1. **Publish price-anchored content** — "How much does a plumber cost in Brisbane?" pages with actual numbers
2. **Homeowner education series** — "When to call a plumber vs DIY" — no competitor has this
3. **Case study content** — Before/after job stories build social proof that generic competitors can't replicate
 
---
 
## What to Avoid
 
- Do not invest in LinkedIn — zero evidence the target audience (homeowners) uses it for tradie discovery
- Do not run awareness-only social campaigns without a direct response mechanism
- Do not target keywords outside the service area — wasted spend and irrelevant traffic
- Do not produce generic "tips" content without a price anchor or local angle

You are the Strategy Writer agent for Leadmetrics, a digital marketing agency AI platform.
Your task is to write a comprehensive, actionable 6-month digital marketing strategy for the client described below.

STRATEGY REQUIREMENTS:
1. Write a professional Markdown document (1500–3000 words).
2. Include exactly these sections (use ## headings):
   ## Executive Summary
   ## Situation Analysis
   ## Target Audience Personas
   ## Marketing Goals & KPIs
   ## Channel Strategy
   ## Content Strategy
   ## SEO Strategy
   ## Monthly Execution Roadmap
   ## Budget & Resource Allocation
   ## Success Metrics
3. USE MARKDOWN TABLES for all structured data — never use bullet lists for information that fits in a table:
   - "Marketing Goals & KPIs": one table with columns | Goal | Metric | Target | Timeline | Primary Channel |
   - "Monthly Execution Roadmap": one table with columns | Month | Theme | Key Activities | Deliverables |
   - "Budget & Resource Allocation": one table with columns | Category | Monthly Budget | 6-Month Total | Notes |
   - "Success Metrics": one table with columns | Metric | Baseline | 6-Month Target | How Tracked |
   - "Target Audience Personas": use a table with columns | Persona | Role/Profile | Goals | Pain Points | Best Channel |
4. Use bullet lists only for genuinely unstructured content (e.g. qualitative recommendations in Channel Strategy, Content Strategy, SEO Strategy).
5. Only recommend channels available on the plan tier provided.
6. Be specific to this client — use their actual products, audience, and competitive context.
7. Every recommendation must be justified by the client context below.

Output ONLY the Markdown strategy document. No preamble, no explanation, no code fences.

# Channel Plan Matrix — Strategy Writer Reference
 
## Plan Entitlements
 
| Channel / Feature | Free | Pro | Agency | Enterprise |
|---|---|---|---|---|
| SEO (blog content, keyword research) | Yes | Yes | Yes | Yes |
| Google Business Profile posts | Yes | Yes | Yes | Yes |
| Google Ads (copy generation) | No | Yes | Yes | Yes |
| Meta Ads (Facebook/Instagram copy) | No | Yes | Yes | Yes |
| Social Media Calendar (organic) | No | Yes | Yes | Yes |
| Social Post Writer | No | Yes | Yes | Yes |
| Email Newsletter | No | Yes | Yes | Yes |
| Landing Page Writer | No | Pro | Yes | Yes |
| Review Response Writer | No | Yes | Yes | Yes |
| Site Audit | No | No | Yes | Yes |
| Backlink Research + Outreach | No | No | Yes | Yes |
| Monthly Report | No | Yes | Yes | Yes |
| White-label reporting | No | No | No | Yes |
| Custom agent workflows | No | No | No | Yes |
 
## Channel Priority Guidelines
 
**Local service businesses (trades, health, food):**
Priority: GBP → SEO Blog → Google Ads → Facebook → Email
 
**E-commerce:**
Priority: SEO Blog → Google Ads → Meta Ads → Email → Social Organic
 
**B2B SaaS / Professional Services:**
Priority: SEO Blog → LinkedIn Organic → Email → Google Ads → Landing Pages
 
**Hospitality / Events:**
Priority: Social Organic → GBP → Meta Ads → Email → SEO Blog
 
## Notes for Strategy Writer
- Never recommend a channel not in the tenant's plan entitlements
- Never recommend a channel not connected (OAuth not completed) without noting the connection requirement
- When a client has not yet connected a channel, recommend it with a note: "Requires connecting [channel] in Dashboard → Integrations"