Blog Content Guidelines

Creating New Posts

1. Copy _TEMPLATE.mdx as your starting point
2. CRITICAL: The file must start with --- at byte 0 (no leading newlines!)
3. All frontmatter fields are required:
   • title - Article title
   • date - Publication date (YYYY-MM-DD)
   • description - SEO description (1-2 sentences)
   • author - Use "Undercover Agent"
   • image - Featured image (optional - omit for text-only posts)
   • tags - Array of relevant tags

Brand Rules

• NO EM DASHES (—) - Use regular dashes, colons, or restructure sentences
• Keep titles under 60 characters for SEO
• Include a <div class="my-8 p-6 bg-gradient-to-r from-[var(--color-cyan)] to-[var(--color-navy)] rounded-xl text-white"><h3 class="text-xl font-bold mb-3">Catch Failures Before Production</h3><p class="mb-4 text-white/90 leading-relaxed">Run secret-shopper QA continuously and surface hidden chatbot failures before customers do.</p><a href="/weekly-brief" class="inline-block bg-white text-[var(--color-navy)] font-semibold px-6 py-3 rounded-lg hover:bg-gray-100 transition-colors">Start weekly brief</a></div> component at the end

File Naming

Use kebab-case: your-article-title.mdx

For SEO series, prefix with numbers: 1-first-topic.mdx, 2-second-topic.mdx