feat: add blog to website using MkDocs Material blog plugin

Enables the built-in Material blog plugin at /docs/blog/ for SEO content
about ralph loops, autonomous agents, and harness engineering. Includes
BlogPosting JSON-LD structured data, article og:type for posts, author
profiles, and a seed welcome post.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: 2 people

docs/blog/.authors.yml

@@ -0,0 +1,5 @@
+authors:
+  kasper:
+    name: Kasper Junge
+    description: Creator of Ralphify
+    avatar: https://github.com/kasperjunge.png

docs/blog/index.md

@@ -0,0 +1,6 @@
+---
+title: Blog
+description: Articles about ralph loops, autonomous AI agents, and harness engineering.
+---
+
+# Blog

docs/blog/posts/welcome.md

@@ -0,0 +1,27 @@
+---
+date: 2026-03-24
+categories:
+  - Announcements
+authors:
+  - kasper
+description: Introducing the Ralphify blog — where we'll share insights on ralph loops, autonomous agents, and harness engineering.
+---
+
+# Welcome to the Ralphify Blog
+
+This is the official Ralphify blog. We'll be writing about ralph loops, autonomous long-running agents, harness engineering, and everything we learn building tools for agentic workflows.
+
+<!-- more -->
+
+## What to expect
+
+We started Ralphify because we believe autonomous AI coding loops are the future of software development. Not as a replacement for human judgment, but as a way to keep the work moving when you're not at the keyboard.
+
+Here's what we'll be covering:
+
+- **Ralph loops in practice** — real-world patterns, prompt engineering for loops, and lessons from running agents autonomously.
+- **Harness engineering** — the emerging discipline of designing systems that keep AI agents productive, safe, and on-track over long runs.
+- **Announcements** — new releases, features, and what's coming next for Ralphify.
+- **Opinions** — our take on where autonomous agents are headed and what developers should be thinking about.
+
+Stay tuned.

docs/overrides/main.html

@@ -32,7 +32,12 @@
   {% endif %}
 
   <!-- Open Graph -->
+  {% if page and page.meta and page.meta.date %}
+  <meta property="og:type" content="article">
+  <meta property="article:published_time" content="{{ page.meta.date }}">
+  {% else %}
   <meta property="og:type" content="website">
+  {% endif %}
   <meta property="og:title" content="{{ page_title }}">
   <meta property="og:description" content="{{ page_desc }}">
   <meta property="og:url" content="{{ page_url }}">
@@ -126,8 +131,32 @@
   </script>
   {% endif %}
 
+  <!-- BlogPosting structured data for blog posts -->
+  {% if page and page.meta and page.meta.date and not page.is_homepage %}
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "BlogPosting",
+    "headline": "{{ page.title }}",
+    "description": "{{ page_desc }}",
+    "url": "{{ page_url }}",
+    "datePublished": "{{ page.meta.date }}",
+    {% if page.meta.git_revision_date_localized_raw_iso_date %}
+    "dateModified": "{{ page.meta.git_revision_date_localized_raw_iso_date }}",
+    {% endif %}
+    "author": {
+      "@type": "Organization",
+      "name": "Computerlove Technologies",
+      "url": "https://github.com/computerlovetech"
+    },
+    "publisher": {
+      "@type": "Organization",
+      "name": "Computerlove Technologies"
+    }
+  }
+  </script>
   <!-- TechArticle structured data for docs pages -->
-  {% if page and page.title and not page.is_homepage %}
+  {% elif page and page.title and not page.is_homepage %}
   <script type="application/ld+json">
   {
     "@context": "https://schema.org",

mkdocs.yml

@@ -73,6 +73,17 @@ plugins:
   - search:
       separator: '[\s\-\.]+'
       lang: en
+  - blog:
+      blog_dir: blog
+      blog_toc: true
+      post_date_format: long
+      post_url_format: "{slug}"
+      post_readtime: true
+      post_excerpt: required
+      categories: true
+      archive: true
+      authors: true
+      pagination_per_page: 10
   - git-revision-date-localized:
       enable_creation_date: true
       type: timeago
@@ -101,6 +112,7 @@ nav:
     - Quick Reference: quick-reference.md
     - CLI: cli.md
     - Python API: api.md
+  - Blog: blog/index.md
   - Help:
     - Troubleshooting: troubleshooting.md
     - Changelog: changelog.md

website/index.html

@@ -190,6 +190,7 @@
       <div class="nav-links">
         <a href="docs/">Docs</a>
         <a href="docs/cookbook/">Cookbook</a>
+        <a href="docs/blog/">Blog</a>
         <a href="https://github.com/computerlovetech/ralphify" target="_blank" rel="noopener noreferrer">GitHub</a>
         <a href="docs/getting-started/" class="nav-cta">Get Started</a>
       </div>
@@ -615,6 +616,7 @@ <h3>Documentation</h3>
           <li><a href="docs/getting-started/">Getting Started</a></li>
           <li><a href="docs/cookbook/">Cookbook</a></li>
           <li><a href="docs/">Full Docs</a></li>
+          <li><a href="docs/blog/">Blog</a></li>
         </ul>
       </div>
       <div class="footer-col">

website/sitemap.xml

@@ -56,6 +56,11 @@
     <changefreq>monthly</changefreq>
     <priority>0.7</priority>
   </url>
+  <url>
+    <loc>https://ralphify.co/docs/blog/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
   <url>
     <loc>https://ralphify.co/docs/troubleshooting/</loc>
     <changefreq>monthly</changefreq>