Article Generation

Architecture

Every article is produced by a multi-stage pipeline designed for quality and consistency. The key insight: separate research from writing. One AI call researches the topic deeply, then multiple parallel writers execute the plan.

Stage 1: The Brain

A single AI call with web search access creates an Article Blueprint — a comprehensive plan that guides all downstream work. This stage:

• - Searches the web for authoritative sources and recent data
• - Analyzes the top 10 search results for the target keyword
• - Chooses a unique angle (contrarian, data-driven, insider-perspective, myth-busting, comprehensive-guide, or case-study)
• - Plans 6-10 sections with specific content briefs, word counts, and source assignments
• - Writes the SEO title (50-60 chars), H1 (60-70 chars), and meta description (150-160 chars)
• - Creates a Key Takeaways summary (4-5 bullets for featured snippet optimization)
• - Plans image descriptions with a consistent artistic style
• - Plans FAQ questions for FAQ schema rich snippets

Blueprint Output

The blueprint is a structured JSON document:

{
  "title": "SEO-optimized title tag (50-60 chars)",
  "h1": "H1 heading optimized for search (60-70 chars)",
  "metaDescription": "Meta description with keyword (150-160 chars)",
  "angle": {
    "type": "data-driven",
    "headline": "The unique angle for this article",
    "keyMessage": "Core insight in 1-2 sentences"
  },
  "writingTone": "Analytical and balanced",
  "tldr": {
    "heading": "Key Takeaways",
    "bullets": ["Point 1", "Point 2", "Point 3", "Point 4"]
  },
  "sections": [
    {
      "heading": "Section Heading",
      "type": "body",
      "targetWordCount": 300,
      "contentBrief": "What this section should cover...",
      "keyPoints": ["Point to cover"],
      "sourcesToCite": [{ "fact": "...", "sourceUrl": "https://..." }],
      "image": { "description": "EDITORIAL ILLUSTRATION: ...", "alt": "..." }
    }
  ],
  "imageStyle": {
    "style": "EDITORIAL ILLUSTRATION",
    "palette": ["#003366", "#FF6B35", "#FFFFFF"],
    "mood": "professional and confident"
  }
}

Stage 2: Section Writers

Each blueprint section is written in parallel by a specialized AI writer. Writers receive:

• - The content brief and key points from the blueprint
• - Pre-researched sources with specific facts to cite
• - Image/video placement instructions
• - Word count target (with +/- 50 word tolerance)
• - Writing tone and business context

Writers do NOT have web search — all research is done in Stage 1. This makes them fast and cheap while ensuring factual accuracy through pre-vetted sources.

Image Generation

After content is complete, a dedicated image generation task creates 3-4 illustrations:

• - 1 featured image — hero/cover image for the article
• - 2-3 section images — placed within the article body

All images use the same artistic template selected by The Brain. Available styles include:

Images are generated using Recraft v4 (via Replicate), uploaded to permanent cloud storage, and the URLs are embedded in the article content before delivery.

Article Structure

The final compiled article follows this structure:

*Last Updated: March 15, 2026*

## Key Takeaways
- Insight 1 from the article
- Insight 2 from the article
- Insight 3 from the article

## Introduction
Direct answer to the search query in the first 40-60 words...

![Section image alt text](https://storage.googleapis.com/.../image.webp)

## Body Sections (Multiple H2s)
Each section covers a specific aspect of the topic...

### Subsections (H3s)
Deeper dives within a section...

## FAQ
### Common question about the topic?
Clear, concise answer.

## Key Takeaways (Actionable)
Summary with actionable bullet points.

## Conclusion
Final summary with call-to-action.

Mandatory Section Types

Quality Controls

• - Source validation — URLs from web search are verified against real results
• - Keyword density — tracked and scored (target: natural, not stuffed)
• - Word count enforcement — each section stays within target +/- 50 words
• - Style consistency — all images validated to use the same artistic template
• - Content sanitization — AI artifacts (anchor IDs, preamble text, em dashes) stripped automatically
• - SEO scoring — 0-100 score based on keyword placement, word count, heading structure
• - No publish without images — articles with failed images are held until images succeed

Cost per Article

The pipeline is optimized for cost efficiency: