Content Brief Writer

interface ContentBriefWriterInput {
  tenantId:          string;
  keywordCluster:    KeywordCluster;      // full output from Keyword Researcher
  contentGoal:       'new_blog_post' | 'optimise_existing' | 'landing_page';
  targetUrl?:        string;              // if optimising an existing page
  wordCountTarget?:  number;             // optional override; agent suggests if omitted
  campaignId?:       string;
}
 
interface KeywordCluster {
  primaryKeyword:     KeywordData;
  secondaryKeywords:  KeywordData[];
  lsiTerms:           string[];
  contentGapOpportunity: string;
  serpFeatures:       string[];
}
 
interface KeywordData {
  keyword:    string;
  volume:     number;
  difficulty: number;
  intent:     'informational' | 'commercial' | 'transactional' | 'navigational';
  cpc?:       number;
}

interface ContentBriefWriterOutput {
  tenantId:                    string;
  generatedAt:                 string;       // ISO timestamp
  contentGoal:                 string;
  title:                       string;       // recommended H1 / article title
  metaDescription:             string;       // 150–160 chars
  h1:                          string;       // same as title unless A/B variant provided
  outline:                     OutlineSection[];
  targetWordCount:             number;
  wordCountRationale:          string;
  primaryKeyword:              string;
  secondaryKeywords:           string[];
  searchIntent:                string;
  competitorUrls:              CompetitorInsight[];
  featuredSnippetOpportunity:  FeaturedSnippetOpportunity | null;
  tone:                        string;
  internalLinkTargets:         InternalLink[];
  existingContentToAvoid:      string[];     // titles of published content too similar to this brief
}
 
interface OutlineSection {
  h2:                      string;
  keyPoints:               string[];
  internalLinkOpportunity: InternalLink | null;
  wordCountTarget:         number;
}
 
interface CompetitorInsight {
  url:          string;
  wordCount:    number;
  mainAngle:    string;
  gapWeCanFill: string;
}
 
interface FeaturedSnippetOpportunity {
  format:        'paragraph' | 'numbered list' | 'table' | 'definition';
  targetSection: string;   // which H2 to optimise for the snippet
  recommendedLength: number;  // chars for paragraph format, or row count for list/table
}
 
interface InternalLink {
  anchorText: string;
  targetUrl:  string;
  targetTitle: string;
  rationale:  string;
}

## SEO Content Brief
**Topic:** B2B SaaS Onboarding Best Practices
**Generated:** 2026-03-01 | **Goal:** New Blog Post
 
---
 
### Title (H1)
B2B SaaS Onboarding Best Practices: A Step-by-Step Guide for 2026
 
### Meta Description
Reduce churn and increase trial-to-paid conversion with these proven B2B SaaS onboarding
best practices — from activation flows to automated email sequences. (158 chars)
 
### Target Word Count
2,200–2,600 words
**Rationale:** Top 3 ranking pages average 2,380 words. Competitor gap analysis shows the
featured snippet answer is currently only 2 sentences — a comprehensive guide will outcompete.
 
---
 
### Outline
 
**H2: What Is B2B SaaS Onboarding (And Why Most Companies Get It Wrong)**
- Define onboarding in the B2B context vs. B2C
- Stat: 63% of customers consider onboarding experience when deciding to renew (Wyzowl)
- Common failure modes: too much friction, too little guidance, no activation milestone defined
*Internal link opportunity:* [What Is Product-Led Growth → /blog/product-led-growth]
 
**H2: The 5-Step B2B SaaS Onboarding Framework**
- Step 1: Define activation — what does "value delivered" look like for this product?
- Step 2: Build the minimum viable onboarding flow (3–5 steps max)
- Step 3: Segment users by role and use case — enterprise vs. SMB onboarding differ
- Step 4: Automate the email sequence (welcome, day 3 check-in, day 7 engagement nudge)
- Step 5: Measure time-to-value, not just completion rates
 
### Featured Snippet Opportunity
**Format:** Numbered list | **Target section:** H2 "5-Step Framework"
Keep the list items to 8–12 words each. Google currently shows a 5-item list from a competitor;
a 6-step list with clearer action verbs should displace it.
 
### Competitor Insights
| URL | Word Count | Angle | Gap We Can Fill |
|---|---|---|---|
| intercom.com/blog/saas-onboarding | 2,100 | Product tour focus | Missing the email sequence layer |
| chameleon.io/blog/onboarding-guide | 2,800 | Enterprise-heavy | No SMB-specific guidance |

You are the Content Brief Writer agent for Leadmetrics, a digital marketing agency AI platform.
Your task is to create a detailed SEO content brief for a single blog post or landing page,
given a target keyword and client context.

BRIEF REQUIREMENTS:
1. Produce a structured Markdown brief with these sections:
   ## Content Brief: [Title]
   **Target Keyword:** <primary keyword>
   **Secondary Keywords:** <comma-separated list>
   **Search Intent:** <informational / commercial / transactional>
   **Target Word Count:** <range>
   **Target Audience:** <description>

   ## Proposed Title Options
   (3 title variants — H1 optimised for CTR and keyword)

   ## Outline
   (Full H2/H3 outline with guidance notes for each section)

   ## Key Points to Cover
   (Bullet list of must-include facts, angles, or claims)

   ## Internal Link Opportunities
   (Suggested pages on the client's site to link to/from)

   ## CTA Recommendation
   (What action should the reader take at the end?)

2. The brief must be actionable enough for the Blog Writer agent to write without additional context.
3. Align tone guidance with the client's brand voice.
4. Include at least one data point, statistic, or research angle the writer should incorporate.

Output ONLY the content brief. No preamble, no explanation.