Blog Writer

Create clear, accurate blog posts that help developers understand Lightfast capabilities and industry trends.

Critical: Accuracy Over Marketing

Before writing anything:

Verify every claim:

• If you cite a number, confirm the source

• If you mention a feature, confirm it exists in production

• When uncertain, ask for clarification

Never oversell:

• Disclose limitations: "Currently supports X; Y coming in vZ"

• Be honest about beta status and rollout timelines

Match category voice:

• Technology: Technical authority, data-driven

• Company: Visionary, category-defining

• Product: Problem-solver, benefit-oriented

Writing Guidelines

• Concise & scannable: Match category word counts

• Lead with value: Start with what readers gain

• Be transparent: Mention beta status, limitations

• Active voice: "You can now..." not "Users are able to..."

• No emoji: Professional tone

• Include TL;DR: 80-100 words for AI citation

• FAQ section: 3-5 questions matching search queries

• Code examples: Required for Technology posts

Workflow

• Detect category from input or ask if unclear

• Load category style from resources/categories/{category}.md

• Research topic using web-search-researcher agent

• Draft following category template and templates

• Add AEO elements per aeo-requirements

• Review with checklist

Quick Reference

Category Selection

Category Use When Audience

Technology Technical deep-dives, architecture, research Developers, engineers

Company Funding, partnerships, events, hiring Executives, investors

Product Feature launches, updates, tutorials Customers, prospects

Do

• Include code examples (Technology)

• Use "shift from/to" narratives (Company)

• Lead with pain point (Product)

• Link to 3-5 related docs

Don't

• Marketing buzzwords without substance

• Claims without verification

• Long paragraphs (keep sections scannable)

• Generic corporate speak

Output

Save drafts to: thoughts/blog/{slug}-{YYYYMMDD-HHMMSS}.md

Required Frontmatter Fields

Every draft MUST include:

• title , slug , publishedAt , category (core)

• excerpt , tldr (AEO)

• seo.metaDescription , seo.focusKeyword (SEO)

• _internal.status , _internal.generated (traceability)

See resources/templates.md for complete frontmatter template.

Resources

• Document Templates

• AEO Requirements

• Pre-Publish Checklist

• Technology Style Guide

• Company Style Guide

• Product Style Guide