diff --git a/.vitepress/config.ts b/.vitepress/config.ts
index 552738f..efc28c3 100644
--- a/.vitepress/config.ts
+++ b/.vitepress/config.ts
@@ -17,14 +17,40 @@ export default defineConfig({
   base: '/',
   title: 'Cycles Docs',
   description: 'Documentation for Cycles, a budget authority for autonomous execution.',
-  srcExclude: ['cycles-protocol/**', 'cycles-server-admin/**'],
+  cleanUrls: true,
+  lang: 'en',
+  titleTemplate: ':title - Cycles Docs',
+  srcExclude: ['README.md', 'cycles-protocol/**', 'cycles-server-admin/**'],
   head: [
     ['link', { rel: 'icon', href: '/runcycles-favicon.png' }],
+    ['meta', { property: 'og:type', content: 'website' }],
+    ['meta', { property: 'og:title', content: 'Cycles Docs' }],
+    ['meta', { property: 'og:description', content: 'Documentation for Cycles, a budget authority for autonomous execution.' }],
+    ['meta', { property: 'og:image', content: 'https://runcycles.io/runcycles-logo-1k.png' }],
+    ['meta', { property: 'og:url', content: 'https://runcycles.io' }],
+    ['meta', { name: 'twitter:card', content: 'summary' }],
   ],
+  sitemap: {
+    hostname: 'https://runcycles.io'
+  },
+  markdown: {
+    image: {
+      lazyLoading: true
+    }
+  },
   lastUpdated: true,
   themeConfig: {
     search: {
-      provider: 'local'
+      provider: 'local',
+      options: {
+        detailedView: true,
+        miniSearch: {
+          searchOptions: {
+            fuzzy: 0.2,
+            prefix: true,
+          }
+        }
+      }
     },
     logo: '/runcycles-logo-64.png',
     externalLinkIcon: true,
@@ -50,7 +76,7 @@ export default defineConfig({
         text: 'API Reference',
         items: [
           { text: 'Cycles Protocol API', link: '/api/' },
-          { text: 'RunCyles Admin API', link: '/admin-api/' },
+          { text: 'RunCycles Admin API', link: '/admin-api/' },
         ],
       },
       { text: 'Protocol', link: 'https://github.com/runcycles/cycles-protocol' },
@@ -68,7 +94,7 @@ export default defineConfig({
       ],
       '/admin-api/': [
         {
-          text: 'RunCyles Admin API',
+          text: 'RunCycles Admin API',
           items: [
             { text: 'Overview', link: '/admin-api/' },
             ...adminApiSidebar.generateSidebarGroups(),
@@ -196,6 +222,10 @@ export default defineConfig({
         }
       ],
     },
+    footer: {
+      message: 'Released under the Apache 2.0 License.',
+      copyright: 'Copyright 2024-present RunCycles'
+    },
     socialLinks: [
       { icon: 'github', link: 'https://github.com/runcycles/docs' }
     ]
diff --git a/.vitepress/theme/index.ts b/.vitepress/theme/index.ts
index eb151f8..3d2757c 100644
--- a/.vitepress/theme/index.ts
+++ b/.vitepress/theme/index.ts
@@ -1,6 +1,8 @@
 import DefaultTheme from 'vitepress/theme'
 import type { Theme } from 'vitepress'
+import { useRoute } from 'vitepress'
 import { theme, useOpenapi } from 'vitepress-openapi/client'
+import { nextTick, onMounted, watch } from 'vue'
 import 'vitepress-openapi/dist/style.css'
 import spec from '../../public/openapi.json'
 
@@ -9,5 +11,18 @@ export default {
   async enhanceApp({ app }) {
     useOpenapi({ spec })
     theme.enhanceApp({ app })
+  },
+  setup() {
+    const route = useRoute()
+    onMounted(() => {
+      watch(
+        () => route.path,
+        () => {
+          if (document.startViewTransition) {
+            document.startViewTransition(() => nextTick())
+          }
+        }
+      )
+    })
   }
 } satisfies Theme
diff --git a/admin-api/index.md b/admin-api/index.md
index b8c8717..c0db49d 100644
--- a/admin-api/index.md
+++ b/admin-api/index.md
@@ -2,6 +2,7 @@
 aside: false
 outline: false
 title: Admin API Reference
+description: Interactive API reference for the RunCycles Admin API. Manage budgets, tenants, and governance policies.
 ---
 
 <script setup lang="ts">
diff --git a/api/index.md b/api/index.md
index 14ad866..42d8c5a 100644
--- a/api/index.md
+++ b/api/index.md
@@ -2,6 +2,7 @@
 aside: false
 outline: false
 title: API Reference
+description: Interactive API reference for the Cycles Protocol. Explore endpoints for reservations, commits, events, balances, and more.
 ---
 
 <OASpec />
diff --git a/changelog.md b/changelog.md
index f229f0e..5d5aa9a 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,3 +1,8 @@
+---
+title: "Changelog"
+description: "Release history and version notes for the Cycles Protocol and reference implementations."
+---
+
 # Changelog
 
 Release history for the Cycles Protocol and reference implementations.
diff --git a/concepts/from-observability-to-enforcement-how-teams-evolve-from-dashboards-to-budget-authority.md b/concepts/from-observability-to-enforcement-how-teams-evolve-from-dashboards-to-budget-authority.md
index 2559a95..b04b0cf 100644
--- a/concepts/from-observability-to-enforcement-how-teams-evolve-from-dashboards-to-budget-authority.md
+++ b/concepts/from-observability-to-enforcement-how-teams-evolve-from-dashboards-to-budget-authority.md
@@ -1,3 +1,8 @@
+---
+title: "From Observability to Enforcement: How Teams Evolve from Dashboards to Budget Authority"
+description: "Explore how teams progress from dashboards and alerts to runtime budget enforcement as autonomous systems mature."
+---
+
 # From Observability to Enforcement: How Teams Evolve from Dashboards to Budget Authority
 
 Most teams do not begin with enforcement.
diff --git a/concepts/how-cycles-compares-to-rate-limiters-observability-provider-caps-in-app-counters-and-job-schedulers.md b/concepts/how-cycles-compares-to-rate-limiters-observability-provider-caps-in-app-counters-and-job-schedulers.md
index 8b0d25b..d08a36b 100644
--- a/concepts/how-cycles-compares-to-rate-limiters-observability-provider-caps-in-app-counters-and-job-schedulers.md
+++ b/concepts/how-cycles-compares-to-rate-limiters-observability-provider-caps-in-app-counters-and-job-schedulers.md
@@ -1,3 +1,8 @@
+---
+title: "How Cycles Compares to Rate Limiters, Observability, Provider Caps, In-App Counters, and Job Schedulers"
+description: "See how Cycles differs from rate limiters, observability tools, provider caps, in-app counters, and job schedulers for budget governance."
+---
+
 # How Cycles Compares to Rate Limiters, Observability, Provider Caps, In-App Counters, and Job Schedulers
 
 Teams building autonomous systems usually already have some controls in place.
diff --git a/concepts/idempotency-retries-and-concurrency-why-cycles-is-built-for-real-failure-modes.md b/concepts/idempotency-retries-and-concurrency-why-cycles-is-built-for-real-failure-modes.md
index 1dbe6bf..e4385cd 100644
--- a/concepts/idempotency-retries-and-concurrency-why-cycles-is-built-for-real-failure-modes.md
+++ b/concepts/idempotency-retries-and-concurrency-why-cycles-is-built-for-real-failure-modes.md
@@ -1,3 +1,8 @@
+---
+title: "Idempotency, Retries, and Concurrency: Why Cycles Is Built for Real Failure Modes"
+description: "Learn how Cycles handles idempotency, retries, and concurrency to provide reliable budget enforcement under real-world failure conditions."
+---
+
 # Idempotency, Retries, and Concurrency: Why Cycles Is Built for Real Failure Modes
 
 Most budget systems look correct in the happy path.
diff --git a/concepts/what-cycles-is-not-billing-rate-limiting-orchestration-and-other-category-confusion.md b/concepts/what-cycles-is-not-billing-rate-limiting-orchestration-and-other-category-confusion.md
index ec91472..60d9113 100644
--- a/concepts/what-cycles-is-not-billing-rate-limiting-orchestration-and-other-category-confusion.md
+++ b/concepts/what-cycles-is-not-billing-rate-limiting-orchestration-and-other-category-confusion.md
@@ -1,3 +1,8 @@
+---
+title: "What Cycles Is Not: Billing, Rate Limiting, Orchestration, and Other Category Confusion"
+description: "Understand what Cycles is not — it is not billing, rate limiting, orchestration, or observability, but a budget authority for autonomous execution."
+---
+
 # What Cycles Is Not: Billing, Rate Limiting, Orchestration, and Other Category Confusion
 
 When people first encounter Cycles, they often try to map it onto an existing category.
diff --git a/concepts/why-rate-limits-are-not-enough-for-autonomous-systems.md b/concepts/why-rate-limits-are-not-enough-for-autonomous-systems.md
index 89af591..3656dc1 100644
--- a/concepts/why-rate-limits-are-not-enough-for-autonomous-systems.md
+++ b/concepts/why-rate-limits-are-not-enough-for-autonomous-systems.md
@@ -1,3 +1,8 @@
+---
+title: "Why Rate Limits Are Not Enough for Autonomous Systems"
+description: "Learn why rate limits alone cannot govern autonomous systems and how budget authority provides the missing control layer."
+---
+
 # Why Rate Limits Are Not Enough for Autonomous Systems
 
 Autonomous systems do not fail like traditional software.
diff --git a/configuration/client-configuration-reference-for-cycles-spring-boot-starter.md b/configuration/client-configuration-reference-for-cycles-spring-boot-starter.md
index 406a909..f81131a 100644
--- a/configuration/client-configuration-reference-for-cycles-spring-boot-starter.md
+++ b/configuration/client-configuration-reference-for-cycles-spring-boot-starter.md
@@ -1,3 +1,8 @@
+---
+title: "Client Configuration Reference for the Cycles Spring Boot Starter"
+description: "Complete reference for all configuration properties in the Cycles Spring Boot Starter client library."
+---
+
 # Client Configuration Reference for the Cycles Spring Boot Starter
 
 ::: tip Using Python?
diff --git a/configuration/python-client-configuration-reference.md b/configuration/python-client-configuration-reference.md
index 1dc0691..5c7ce5b 100644
--- a/configuration/python-client-configuration-reference.md
+++ b/configuration/python-client-configuration-reference.md
@@ -1,3 +1,8 @@
+---
+title: "Python Client Configuration Reference"
+description: "Complete reference for all configuration options in the runcycles Python client, including connection, retry, and timeout settings."
+---
+
 # Python Client Configuration Reference
 
 This is the complete reference for all configuration options available in the `runcycles` Python client.
diff --git a/configuration/server-configuration-reference-for-cycles.md b/configuration/server-configuration-reference-for-cycles.md
index efa64e2..315cb01 100644
--- a/configuration/server-configuration-reference-for-cycles.md
+++ b/configuration/server-configuration-reference-for-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Server Configuration Reference for Cycles"
+description: "Complete reference for all Cycles server configuration properties, including server, Redis, and Spring Boot settings."
+---
+
 # Server Configuration Reference for Cycles
 
 This is the complete reference for all configuration properties available in the Cycles server.
diff --git a/configuration/spel-expression-reference-for-cycles.md b/configuration/spel-expression-reference-for-cycles.md
index 0844273..50d6239 100644
--- a/configuration/spel-expression-reference-for-cycles.md
+++ b/configuration/spel-expression-reference-for-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "SpEL Expression Reference for Cycles"
+description: "Comprehensive reference for writing SpEL expressions in the @Cycles annotation to dynamically evaluate estimate and actual costs."
+---
+
 # SpEL Expression Reference for Cycles
 
 The `@Cycles` annotation uses Spring Expression Language (SpEL) to evaluate `estimate` and `actual` cost values dynamically. This page is a comprehensive reference for writing SpEL expressions in Cycles.
diff --git a/configuration/typescript-client-configuration-reference.md b/configuration/typescript-client-configuration-reference.md
index 3673ab9..79a5c21 100644
--- a/configuration/typescript-client-configuration-reference.md
+++ b/configuration/typescript-client-configuration-reference.md
@@ -1,3 +1,8 @@
+---
+title: "TypeScript Client Configuration Reference"
+description: "Complete reference for all configuration options in the runcycles TypeScript client, including connection, retry, and timeout settings."
+---
+
 # TypeScript Client Configuration Reference
 
 This is the complete reference for all configuration options available in the `runcycles` TypeScript client.
diff --git a/how-to/adding-cycles-to-an-existing-application.md b/how-to/adding-cycles-to-an-existing-application.md
index 44792da..89ef45b 100644
--- a/how-to/adding-cycles-to-an-existing-application.md
+++ b/how-to/adding-cycles-to-an-existing-application.md
@@ -1,3 +1,8 @@
+---
+title: "Adding Cycles to an Existing Application"
+description: "Incrementally adopt Cycles budget governance in an existing application using shadow mode, single-call wrapping, and staged enforcement."
+---
+
 # Adding Cycles to an Existing Application
 
 This guide covers how to incrementally add budget governance to an application that already makes LLM or API calls. Rather than rewriting your integration layer, you can adopt Cycles in stages.
diff --git a/how-to/api-key-management-in-cycles.md b/how-to/api-key-management-in-cycles.md
index d2b55be..656a243 100644
--- a/how-to/api-key-management-in-cycles.md
+++ b/how-to/api-key-management-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "API Key Management in Cycles"
+description: "Learn how to create, manage, and rotate API keys in Cycles, including tenant isolation and key lifecycle states."
+---
+
 # API Key Management in Cycles
 
 Every request to the Cycles server requires an API key. This page explains how API keys work, how to create and manage them, and how they relate to tenant isolation.
diff --git a/how-to/budget-allocation-and-management-in-cycles.md b/how-to/budget-allocation-and-management-in-cycles.md
index 6e51589..a557c60 100644
--- a/how-to/budget-allocation-and-management-in-cycles.md
+++ b/how-to/budget-allocation-and-management-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Budget Allocation and Management in Cycles"
+description: "Learn how budget allocation works in Cycles, how to set up scope-level budgets, and how to manage them over time."
+---
+
 # Budget Allocation and Management in Cycles
 
 Before you can enforce budgets with Cycles, budgets need to be allocated to scopes. This page explains how budget allocation works, how to set it up, and how to manage budgets over time.
diff --git a/how-to/choosing-the-right-integration-pattern.md b/how-to/choosing-the-right-integration-pattern.md
index 88ee685..32093aa 100644
--- a/how-to/choosing-the-right-integration-pattern.md
+++ b/how-to/choosing-the-right-integration-pattern.md
@@ -1,3 +1,8 @@
+---
+title: "Choosing the Right Integration Pattern"
+description: "Pick the right Cycles integration pattern for your use case: decorator, streaming adapter, middleware, or programmatic client."
+---
+
 # Choosing the Right Integration Pattern
 
 Each Cycles SDK offers multiple integration patterns. This guide helps you pick the right one for your use case.
diff --git a/how-to/common-budget-patterns.md b/how-to/common-budget-patterns.md
index ff49c6e..14f5229 100644
--- a/how-to/common-budget-patterns.md
+++ b/how-to/common-budget-patterns.md
@@ -1,3 +1,8 @@
+---
+title: "Common Budget Patterns"
+description: "Practical recipes for common budget governance scenarios including per-user daily budgets, per-workflow limits, and scope hierarchies."
+---
+
 # Common Budget Patterns
 
 Practical recipes for common budget governance scenarios. Each pattern shows the scope hierarchy and budget allocation needed.
diff --git a/how-to/cost-estimation-cheat-sheet.md b/how-to/cost-estimation-cheat-sheet.md
index f9a05c6..6f31f2e 100644
--- a/how-to/cost-estimation-cheat-sheet.md
+++ b/how-to/cost-estimation-cheat-sheet.md
@@ -1,3 +1,8 @@
+---
+title: "Cost Estimation Cheat Sheet"
+description: "Quick reference for estimating LLM call costs in Cycles, including USD_MICROCENTS conversions and provider pricing tables."
+---
+
 # Cost Estimation Cheat Sheet
 
 This guide answers the most common question when adopting Cycles: **how much should I reserve for a given LLM call?**
diff --git a/how-to/custom-field-resolvers-in-cycles.md b/how-to/custom-field-resolvers-in-cycles.md
index 1ed34f0..a13d293 100644
--- a/how-to/custom-field-resolvers-in-cycles.md
+++ b/how-to/custom-field-resolvers-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Custom Field Resolvers in Cycles"
+description: "Use CyclesFieldResolver to dynamically resolve Subject fields like tenant and workspace at runtime in the Spring Boot Starter."
+---
+
 # Custom Field Resolvers in Cycles
 
 The `CyclesFieldResolver` interface lets you resolve Subject fields dynamically at runtime in the Spring Boot Starter. This is useful when values like tenant, workspace, or agent depend on the current request context, user session, or database lookup.
diff --git a/how-to/error-handling-patterns-in-cycles-client-code.md b/how-to/error-handling-patterns-in-cycles-client-code.md
index e967762..681f90c 100644
--- a/how-to/error-handling-patterns-in-cycles-client-code.md
+++ b/how-to/error-handling-patterns-in-cycles-client-code.md
@@ -1,3 +1,8 @@
+---
+title: "Error Handling Patterns in Cycles Client Code"
+description: "Handle Cycles protocol errors, transport failures, and budget exceeded responses in Python, Java, and TypeScript client code."
+---
+
 # Error Handling Patterns in Cycles Client Code
 
 This guide covers practical patterns for handling Cycles errors in your application — both with the decorator/annotation and with the programmatic client.
diff --git a/how-to/error-handling-patterns-in-python.md b/how-to/error-handling-patterns-in-python.md
index 26195e0..1c0fac7 100644
--- a/how-to/error-handling-patterns-in-python.md
+++ b/how-to/error-handling-patterns-in-python.md
@@ -1,3 +1,8 @@
+---
+title: "Error Handling Patterns in Python"
+description: "Practical patterns for handling Cycles errors in Python using the @cycles decorator and the programmatic CyclesClient."
+---
+
 # Error Handling Patterns in Python
 
 This guide covers practical patterns for handling Cycles errors in Python applications — both with the `@cycles` decorator and with the programmatic `CyclesClient`.
diff --git a/how-to/error-handling-patterns-in-typescript.md b/how-to/error-handling-patterns-in-typescript.md
index df95b10..2985246 100644
--- a/how-to/error-handling-patterns-in-typescript.md
+++ b/how-to/error-handling-patterns-in-typescript.md
@@ -1,3 +1,8 @@
+---
+title: "Error Handling Patterns in TypeScript"
+description: "Practical patterns for handling Cycles errors in TypeScript with withCycles, reserveForStream, and the programmatic CyclesClient."
+---
+
 # Error Handling Patterns in TypeScript
 
 This guide covers practical patterns for handling Cycles errors in TypeScript applications — with `withCycles`, `reserveForStream`, and the programmatic `CyclesClient`.
diff --git a/how-to/handling-streaming-responses-with-cycles.md b/how-to/handling-streaming-responses-with-cycles.md
index 892f093..bd9df93 100644
--- a/how-to/handling-streaming-responses-with-cycles.md
+++ b/how-to/handling-streaming-responses-with-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Handling Streaming Responses with Cycles"
+description: "Learn the reserve, stream, and commit pattern for managing budget reservations with streaming LLM responses in Cycles."
+---
+
 # Handling Streaming Responses with Cycles
 
 Streaming LLM responses require special handling because the actual cost is only known after the stream completes. This guide shows the reserve → stream → commit pattern.
diff --git a/how-to/how-to-estimate-exposure-before-execution-practical-reservation-strategies-for-cycles.md b/how-to/how-to-estimate-exposure-before-execution-practical-reservation-strategies-for-cycles.md
index 64c1cd9..e6a83ba 100644
--- a/how-to/how-to-estimate-exposure-before-execution-practical-reservation-strategies-for-cycles.md
+++ b/how-to/how-to-estimate-exposure-before-execution-practical-reservation-strategies-for-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "How to Estimate Exposure Before Execution: Practical Reservation Strategies for Cycles"
+description: "Practical strategies for estimating budget reservations before execution, including how to handle over- and under-reserving in Cycles."
+---
+
 # How to Estimate Exposure Before Execution: Practical Reservation Strategies for Cycles
 
 One of the first practical questions teams ask when adopting Cycles is:
diff --git a/how-to/how-to-model-tenant-workflow-and-run-budgets-in-cycles.md b/how-to/how-to-model-tenant-workflow-and-run-budgets-in-cycles.md
index 50e9d27..9f8a1b7 100644
--- a/how-to/how-to-model-tenant-workflow-and-run-budgets-in-cycles.md
+++ b/how-to/how-to-model-tenant-workflow-and-run-budgets-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "How to Model Tenant, Workflow, and Run Budgets in Cycles"
+description: "Design budget policies using tenant, workflow, and run scopes to bound autonomous execution across multiple levels in Cycles."
+---
+
 # How to Model Tenant, Workflow, and Run Budgets in Cycles
 
 Once a team understands reserve → commit, the next question is usually:
diff --git a/how-to/how-to-think-about-degradation-paths-in-cycles-deny-downgrade-disable-or-defer.md b/how-to/how-to-think-about-degradation-paths-in-cycles-deny-downgrade-disable-or-defer.md
index 981874d..72912fd 100644
--- a/how-to/how-to-think-about-degradation-paths-in-cycles-deny-downgrade-disable-or-defer.md
+++ b/how-to/how-to-think-about-degradation-paths-in-cycles-deny-downgrade-disable-or-defer.md
@@ -1,3 +1,8 @@
+---
+title: "How to Think About Degradation Paths in Cycles: Deny, Downgrade, Disable, or Defer?"
+description: "Choose the right degradation strategy when a budget boundary is hit: deny, downgrade to a cheaper model, disable features, or defer work."
+---
+
 # How to Think About Degradation Paths in Cycles: Deny, Downgrade, Disable, or Defer?
 
 A budget boundary should not always mean a hard stop.
diff --git a/how-to/integrating-cycles-with-anthropic.md b/how-to/integrating-cycles-with-anthropic.md
index bba2c1b..a1a60ff 100644
--- a/how-to/integrating-cycles-with-anthropic.md
+++ b/how-to/integrating-cycles-with-anthropic.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with Anthropic"
+description: "Guard Anthropic Messages API calls with Cycles budget reservations, including per-tool-call tracking for agentic workflows."
+---
+
 # Integrating Cycles with Anthropic
 
 This guide shows how to guard Anthropic Messages API calls with Cycles budget reservations, including per-tool-call budget tracking for agentic workflows.
diff --git a/how-to/integrating-cycles-with-aws-bedrock.md b/how-to/integrating-cycles-with-aws-bedrock.md
index b7be6d5..7f8aa4d 100644
--- a/how-to/integrating-cycles-with-aws-bedrock.md
+++ b/how-to/integrating-cycles-with-aws-bedrock.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with AWS Bedrock"
+description: "Add budget governance to AWS Bedrock model invocations using the runcycles TypeScript client."
+---
+
 # Integrating Cycles with AWS Bedrock
 
 This guide shows how to add budget governance to AWS Bedrock model invocations using the `runcycles` TypeScript client and the `@aws-sdk/client-bedrock-runtime`.
diff --git a/how-to/integrating-cycles-with-express.md b/how-to/integrating-cycles-with-express.md
index b02850e..645be1c 100644
--- a/how-to/integrating-cycles-with-express.md
+++ b/how-to/integrating-cycles-with-express.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with Express"
+description: "Add budget governance to an Express.js application using reusable middleware and inline patterns with Cycles."
+---
+
 # Integrating Cycles with Express
 
 This guide shows how to add budget governance to an Express.js application using reusable middleware.
diff --git a/how-to/integrating-cycles-with-fastapi.md b/how-to/integrating-cycles-with-fastapi.md
index ee8c155..fc0054a 100644
--- a/how-to/integrating-cycles-with-fastapi.md
+++ b/how-to/integrating-cycles-with-fastapi.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with FastAPI"
+description: "Add budget management to a FastAPI application using middleware, dependency injection, and per-tenant isolation with Cycles."
+---
+
 # Integrating Cycles with FastAPI
 
 This guide shows how to add budget management to a FastAPI application using middleware, dependency injection, per-tenant isolation, and exception handling.
diff --git a/how-to/integrating-cycles-with-google-gemini.md b/how-to/integrating-cycles-with-google-gemini.md
index 5f263f6..1bf64f5 100644
--- a/how-to/integrating-cycles-with-google-gemini.md
+++ b/how-to/integrating-cycles-with-google-gemini.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with Google Gemini"
+description: "Add budget governance to Google Gemini API calls using the runcycles TypeScript client and the @google/generative-ai SDK."
+---
+
 # Integrating Cycles with Google Gemini
 
 This guide shows how to add budget governance to Google Gemini API calls using the `runcycles` TypeScript client and the `@google/generative-ai` SDK.
diff --git a/how-to/integrating-cycles-with-langchain.md b/how-to/integrating-cycles-with-langchain.md
index 6083f5a..68979b9 100644
--- a/how-to/integrating-cycles-with-langchain.md
+++ b/how-to/integrating-cycles-with-langchain.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with LangChain"
+description: "Add budget management to LangChain apps using a custom callback handler that wraps every LLM call with a Cycles reservation."
+---
+
 # Integrating Cycles with LangChain
 
 This guide shows how to add budget management to LangChain applications using a custom callback handler that wraps every LLM call with a Cycles reservation.
diff --git a/how-to/integrating-cycles-with-openai.md b/how-to/integrating-cycles-with-openai.md
index 10cdfb5..70dddce 100644
--- a/how-to/integrating-cycles-with-openai.md
+++ b/how-to/integrating-cycles-with-openai.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with OpenAI"
+description: "Guard OpenAI API calls with Cycles budget reservations for cost-controlled, caps-aware chat completions."
+---
+
 # Integrating Cycles with OpenAI
 
 This guide shows how to guard OpenAI API calls with Cycles budget reservations so that every chat completion is cost-controlled, caps-aware, and observable.
diff --git a/how-to/integrating-cycles-with-openclaw.md b/how-to/integrating-cycles-with-openclaw.md
index 970c868..daeadd6 100644
--- a/how-to/integrating-cycles-with-openclaw.md
+++ b/how-to/integrating-cycles-with-openclaw.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with OpenClaw"
+description: "Add budget enforcement to OpenClaw agents using the cycles-openclaw-budget-guard plugin for automatic reserve, commit, and release."
+---
+
 # Integrating Cycles with OpenClaw
 
 This guide shows how to add budget enforcement to OpenClaw agents using the [`cycles-openclaw-budget-guard`](https://github.com/runcycles/cycles-openclaw-budget-guard) plugin. The plugin handles the full reserve → commit → release lifecycle for both model and tool calls automatically, with no custom code required.
diff --git a/how-to/integrating-cycles-with-vercel-ai-sdk.md b/how-to/integrating-cycles-with-vercel-ai-sdk.md
index 128785b..4065f46 100644
--- a/how-to/integrating-cycles-with-vercel-ai-sdk.md
+++ b/how-to/integrating-cycles-with-vercel-ai-sdk.md
@@ -1,3 +1,8 @@
+---
+title: "Integrating Cycles with the Vercel AI SDK"
+description: "Add budget governance to a Next.js app using the Vercel AI SDK with the reserveForStream pattern for streaming LLM responses."
+---
+
 # Integrating Cycles with the Vercel AI SDK
 
 This guide shows how to add budget governance to a Next.js application using the [Vercel AI SDK](https://sdk.vercel.ai/) and the `runcycles` TypeScript client.
diff --git a/how-to/monitoring-and-alerting.md b/how-to/monitoring-and-alerting.md
index f90bd0b..127513d 100644
--- a/how-to/monitoring-and-alerting.md
+++ b/how-to/monitoring-and-alerting.md
@@ -1,3 +1,8 @@
+---
+title: "Monitoring and Alerting"
+description: "Key metrics, alerting thresholds, and observability patterns for monitoring a production Cycles deployment."
+---
+
 # Monitoring and Alerting
 
 This guide covers key metrics to monitor, alerting thresholds, and observability patterns for a production Cycles deployment.
diff --git a/how-to/production-operations-guide.md b/how-to/production-operations-guide.md
index e55200f..05d4982 100644
--- a/how-to/production-operations-guide.md
+++ b/how-to/production-operations-guide.md
@@ -1,3 +1,8 @@
+---
+title: "Production Operations Guide"
+description: "Run Cycles reliably in production with Redis configuration, high availability, backup strategies, and operational best practices."
+---
+
 # Production Operations Guide
 
 This guide covers what you need to run Cycles reliably in production. It assumes you've already deployed the stack per [Deploy the Full Stack](/quickstart/deploying-the-full-cycles-stack) and are preparing for production traffic.
diff --git a/how-to/security-hardening.md b/how-to/security-hardening.md
index 6a2521b..54227ad 100644
--- a/how-to/security-hardening.md
+++ b/how-to/security-hardening.md
@@ -1,3 +1,8 @@
+---
+title: "Security Hardening"
+description: "Security best practices for production Cycles deployments including network isolation, API key rotation, and access control."
+---
+
 # Security Hardening
 
 This guide covers security best practices for a production Cycles deployment.
diff --git a/how-to/shadow-mode-in-cycles-how-to-roll-out-budget-enforcement-without-breaking-production.md b/how-to/shadow-mode-in-cycles-how-to-roll-out-budget-enforcement-without-breaking-production.md
index 2632b01..5eaade4 100644
--- a/how-to/shadow-mode-in-cycles-how-to-roll-out-budget-enforcement-without-breaking-production.md
+++ b/how-to/shadow-mode-in-cycles-how-to-roll-out-budget-enforcement-without-breaking-production.md
@@ -1,3 +1,8 @@
+---
+title: "Shadow Mode in Cycles: How to Roll Out Budget Enforcement Without Breaking Production"
+description: "Use shadow mode to evaluate Cycles budget policies against real traffic without blocking execution, then safely transition to enforcement."
+---
+
 # Shadow Mode in Cycles: How to Roll Out Budget Enforcement Without Breaking Production
 
 Most teams do not struggle with the idea of budget enforcement.
diff --git a/how-to/testing-with-cycles.md b/how-to/testing-with-cycles.md
index b8d8c3e..86c98e1 100644
--- a/how-to/testing-with-cycles.md
+++ b/how-to/testing-with-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Testing with Cycles"
+description: "How to unit test and integration test code that uses the Cycles decorator, annotation, or programmatic client in Python, Java, and TypeScript."
+---
+
 # Testing with Cycles
 
 This guide covers how to test code that uses the `@cycles` decorator (Python), the `@Cycles` annotation (Java), or the `withCycles` HOF (TypeScript) and the `CyclesClient` interface.
diff --git a/how-to/troubleshooting-and-faq.md b/how-to/troubleshooting-and-faq.md
index 61cfcf3..08fcf04 100644
--- a/how-to/troubleshooting-and-faq.md
+++ b/how-to/troubleshooting-and-faq.md
@@ -1,3 +1,8 @@
+---
+title: "Troubleshooting and FAQ"
+description: "Solutions to common Cycles issues including budget exceeded errors, reservation failures, connectivity problems, and configuration mistakes."
+---
+
 # Troubleshooting and FAQ
 
 Common issues when integrating and operating Cycles, with solutions.
diff --git a/how-to/using-the-cycles-client-programmatically.md b/how-to/using-the-cycles-client-programmatically.md
index 0059fa1..5c367fc 100644
--- a/how-to/using-the-cycles-client-programmatically.md
+++ b/how-to/using-the-cycles-client-programmatically.md
@@ -1,3 +1,8 @@
+---
+title: "Using the Cycles Client Programmatically"
+description: "Use the Cycles programmatic client in Python, Java, and TypeScript for direct control over reservations, commits, and protocol endpoints."
+---
+
 # Using the Cycles Client Programmatically
 
 The decorator / annotation handles most use cases automatically. But sometimes you need direct control — building requests manually, managing the lifecycle yourself, or calling endpoints that the decorator does not cover.
diff --git a/incidents/concurrent-agent-overspend.md b/incidents/concurrent-agent-overspend.md
index e8146b3..0166382 100644
--- a/incidents/concurrent-agent-overspend.md
+++ b/incidents/concurrent-agent-overspend.md
@@ -1,3 +1,8 @@
+---
+title: "Concurrent Agent Overspend"
+description: "How concurrent agents sharing a budget can collectively exceed limits due to race conditions, and how Cycles prevents it."
+---
+
 # Concurrent Agent Overspend
 
 A failure mode where multiple agents sharing a budget each pass local checks but collectively exceed the limit.
diff --git a/incidents/retry-storms-and-idempotency-failures.md b/incidents/retry-storms-and-idempotency-failures.md
index 64892f1..0d1591f 100644
--- a/incidents/retry-storms-and-idempotency-failures.md
+++ b/incidents/retry-storms-and-idempotency-failures.md
@@ -1,3 +1,8 @@
+---
+title: "Retry Storms and Idempotency Failures"
+description: "How retry loops without idempotency create unbounded spend, and how Cycles budget enforcement prevents this failure mode."
+---
+
 # Retry Storms and Idempotency Failures
 
 A common failure mode in autonomous systems where retry logic multiplies cost without bound.
diff --git a/incidents/runaway-agents-tool-loops-and-budget-overruns-the-incidents-cycles-is-designed-to-prevent.md b/incidents/runaway-agents-tool-loops-and-budget-overruns-the-incidents-cycles-is-designed-to-prevent.md
index caade2e..a967221 100644
--- a/incidents/runaway-agents-tool-loops-and-budget-overruns-the-incidents-cycles-is-designed-to-prevent.md
+++ b/incidents/runaway-agents-tool-loops-and-budget-overruns-the-incidents-cycles-is-designed-to-prevent.md
@@ -1,3 +1,8 @@
+---
+title: "Runaway Agents, Tool Loops, and Budget Overruns: The Incidents Cycles Is Designed to Prevent"
+description: "Overview of the real-world incidents Cycles prevents: runaway agents, tool loops, retry storms, and uncontrolled budget overruns."
+---
+
 # Runaway Agents, Tool Loops, and Budget Overruns: The Incidents Cycles Is Designed to Prevent
 
 Most infrastructure gets adopted after a painful incident.
diff --git a/incidents/scope-misconfiguration-and-budget-leaks.md b/incidents/scope-misconfiguration-and-budget-leaks.md
index 41465cc..1020f71 100644
--- a/incidents/scope-misconfiguration-and-budget-leaks.md
+++ b/incidents/scope-misconfiguration-and-budget-leaks.md
@@ -1,3 +1,8 @@
+---
+title: "Scope Misconfiguration and Budget Leaks"
+description: "How misconfigured subject fields cause budget leaks by bypassing scope-level limits, and how to prevent them with Cycles."
+---
+
 # Scope Misconfiguration and Budget Leaks
 
 A failure mode where budget is consumed from unintended scopes due to misconfigured subject fields, or where budget is not properly tracked because scopes don't match.
diff --git a/index.md b/index.md
index 42fcd81..77ff7ab 100644
--- a/index.md
+++ b/index.md
@@ -4,6 +4,9 @@ hero:
   name: "Cycles"
   text: "A budget authority for autonomous execution"
   tagline: "Enforce hard spend limits on AI agents before expensive actions happen — not after. Open protocol, multi-language SDKs, Apache 2.0."
+  image:
+    src: /runcycles-logo-128.png
+    alt: Cycles logo
   actions:
     - theme: brand
       text: "What is Cycles?"
diff --git a/protocol/api-reference-for-the-cycles-protocol.md b/protocol/api-reference-for-the-cycles-protocol.md
index d0edff3..ac1693c 100644
--- a/protocol/api-reference-for-the-cycles-protocol.md
+++ b/protocol/api-reference-for-the-cycles-protocol.md
@@ -1,3 +1,8 @@
+---
+title: "API Reference for the Cycles Protocol"
+description: "Complete developer reference for every Cycles protocol endpoint, including request and response formats, headers, and curl examples."
+---
+
 # API Reference for the Cycles Protocol
 
 This is a developer-friendly reference for every endpoint in the Cycles protocol. Each endpoint includes the request format, response format, and curl examples.
diff --git a/protocol/authentication-tenancy-and-api-keys-in-cycles.md b/protocol/authentication-tenancy-and-api-keys-in-cycles.md
index de595df..4872f6f 100644
--- a/protocol/authentication-tenancy-and-api-keys-in-cycles.md
+++ b/protocol/authentication-tenancy-and-api-keys-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Authentication, Tenancy, and API Keys in Cycles"
+description: "How Cycles authenticates API requests and scopes all budget operations to tenants using API keys."
+---
+
 # Authentication, Tenancy, and API Keys in Cycles
 
 Every request to the Cycles API is authenticated. Every budget operation is tenant-scoped.
diff --git a/protocol/caps-and-the-three-way-decision-model-in-cycles.md b/protocol/caps-and-the-three-way-decision-model-in-cycles.md
index e2b1bd6..88d18b8 100644
--- a/protocol/caps-and-the-three-way-decision-model-in-cycles.md
+++ b/protocol/caps-and-the-three-way-decision-model-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Caps and the Three-Way Decision Model in Cycles"
+description: "How Cycles uses ALLOW, ALLOW_WITH_CAPS, and DENY decisions to provide nuanced budget enforcement beyond binary allow/deny."
+---
+
 # Caps and the Three-Way Decision Model in Cycles
 
 Most budget systems make a binary decision: allow or deny.
diff --git a/protocol/commit-overage-policies-in-cycles-reject-allow-if-available-and-allow-with-overdraft.md b/protocol/commit-overage-policies-in-cycles-reject-allow-if-available-and-allow-with-overdraft.md
index 1b59ce1..d18404d 100644
--- a/protocol/commit-overage-policies-in-cycles-reject-allow-if-available-and-allow-with-overdraft.md
+++ b/protocol/commit-overage-policies-in-cycles-reject-allow-if-available-and-allow-with-overdraft.md
@@ -1,3 +1,8 @@
+---
+title: "Commit Overage Policies in Cycles: REJECT, ALLOW_IF_AVAILABLE, and ALLOW_WITH_OVERDRAFT"
+description: "How Cycles handles commits that exceed the reserved amount using three overage policies: REJECT, ALLOW_IF_AVAILABLE, and ALLOW_WITH_OVERDRAFT."
+---
+
 # Commit Overage Policies in Cycles: REJECT, ALLOW_IF_AVAILABLE, and ALLOW_WITH_OVERDRAFT
 
 When actual usage differs from the reserved estimate, the system needs a policy for what to do.
diff --git a/protocol/debt-overdraft-and-the-over-limit-model-in-cycles.md b/protocol/debt-overdraft-and-the-over-limit-model-in-cycles.md
index 201a4da..5045fa0 100644
--- a/protocol/debt-overdraft-and-the-over-limit-model-in-cycles.md
+++ b/protocol/debt-overdraft-and-the-over-limit-model-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Debt, Overdraft, and the Over-Limit Model in Cycles"
+description: "Learn how Cycles handles budget overruns, tracks debt from overspend, and models overdraft recovery for production systems."
+---
+
 # Debt, Overdraft, and the Over-Limit Model in Cycles
 
 Budget enforcement in Cycles is designed to prevent unbounded execution.
diff --git a/protocol/dry-run-shadow-mode-evaluation-in-cycles.md b/protocol/dry-run-shadow-mode-evaluation-in-cycles.md
index cdd3392..4074424 100644
--- a/protocol/dry-run-shadow-mode-evaluation-in-cycles.md
+++ b/protocol/dry-run-shadow-mode-evaluation-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Dry Run: Shadow Mode Evaluation in Cycles"
+description: "Test budget enforcement in shadow mode with dry run, evaluating the full reservation path without modifying budget state."
+---
+
 # Dry Run: Shadow Mode Evaluation in Cycles
 
 Before enforcing budget limits in production, teams need a way to test the full reservation path without actually holding budget.
diff --git a/protocol/error-codes-and-error-handling-in-cycles.md b/protocol/error-codes-and-error-handling-in-cycles.md
index bb182c7..3b76588 100644
--- a/protocol/error-codes-and-error-handling-in-cycles.md
+++ b/protocol/error-codes-and-error-handling-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Error Codes and Error Handling in Cycles"
+description: "Reference for all Cycles error codes and structured error responses, with guidance on handling each failure condition."
+---
+
 # Error Codes and Error Handling in Cycles
 
 Cycles uses structured error responses with specific error codes for every failure condition.
diff --git a/protocol/how-decide-works-in-cycles-preflight-budget-checks-without-reservation.md b/protocol/how-decide-works-in-cycles-preflight-budget-checks-without-reservation.md
index d6c3adc..8a2859c 100644
--- a/protocol/how-decide-works-in-cycles-preflight-budget-checks-without-reservation.md
+++ b/protocol/how-decide-works-in-cycles-preflight-budget-checks-without-reservation.md
@@ -1,3 +1,8 @@
+---
+title: "How Decide Works in Cycles: Preflight Budget Checks Without Reservation"
+description: "Use the Cycles decide endpoint to perform read-only preflight budget checks without creating a reservation."
+---
+
 # How Decide Works in Cycles: Preflight Budget Checks Without Reservation
 
 Sometimes a system needs to know whether an action would be allowed before committing to it.
diff --git a/protocol/how-events-work-in-cycles-direct-debit-without-reservation.md b/protocol/how-events-work-in-cycles-direct-debit-without-reservation.md
index 23974e5..12bdf13 100644
--- a/protocol/how-events-work-in-cycles-direct-debit-without-reservation.md
+++ b/protocol/how-events-work-in-cycles-direct-debit-without-reservation.md
@@ -1,3 +1,8 @@
+---
+title: "How Events Work in Cycles: Direct Debit Without Reservation"
+description: "Understand how Cycles events record usage directly without a reservation, for known-cost or externally sourced budget charges."
+---
+
 # How Events Work in Cycles: Direct Debit Without Reservation
 
 The core Cycles lifecycle is reserve → execute → commit.
diff --git a/protocol/how-reserve-commit-works-in-cycles.md b/protocol/how-reserve-commit-works-in-cycles.md
index 27155af..3eb5d4e 100644
--- a/protocol/how-reserve-commit-works-in-cycles.md
+++ b/protocol/how-reserve-commit-works-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "How Reserve → Commit Works in Cycles"
+description: "Understand the reserve-then-commit lifecycle in Cycles that enforces budget limits before work begins, not after."
+---
+
 # How Reserve → Commit Works in Cycles
 
 Most systems discover usage after work is already done.
diff --git a/protocol/how-scope-derivation-works-in-cycles.md b/protocol/how-scope-derivation-works-in-cycles.md
index 408d057..ccaeccf 100644
--- a/protocol/how-scope-derivation-works-in-cycles.md
+++ b/protocol/how-scope-derivation-works-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "How Scope Derivation Works in Cycles"
+description: "Learn how the Cycles server derives hierarchical budget scopes from subject fields to enforce limits at multiple levels."
+---
+
 # How Scope Derivation Works in Cycles
 
 Budget enforcement in Cycles is hierarchical.
diff --git a/protocol/querying-balances-in-cycles-understanding-budget-state.md b/protocol/querying-balances-in-cycles-understanding-budget-state.md
index 7f5416f..4f19456 100644
--- a/protocol/querying-balances-in-cycles-understanding-budget-state.md
+++ b/protocol/querying-balances-in-cycles-understanding-budget-state.md
@@ -1,3 +1,8 @@
+---
+title: "Querying Balances in Cycles: Understanding Budget State"
+description: "Query current budget state in Cycles to see allocations, reservations, spend, and remaining balance for any scope."
+---
+
 # Querying Balances in Cycles: Understanding Budget State
 
 Budget enforcement is only useful if the system can also answer: **how much is left?**
diff --git a/protocol/reservation-recovery-and-listing-in-cycles.md b/protocol/reservation-recovery-and-listing-in-cycles.md
index 547bf91..1245877 100644
--- a/protocol/reservation-recovery-and-listing-in-cycles.md
+++ b/protocol/reservation-recovery-and-listing-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Reservation Recovery and Listing in Cycles"
+description: "How to list, filter, and recover reservations in Cycles when clients crash or lose reservation IDs."
+---
+
 # Reservation Recovery and Listing in Cycles
 
 In production systems, things go wrong.
diff --git a/protocol/reservation-ttl-grace-period-and-extend-in-cycles.md b/protocol/reservation-ttl-grace-period-and-extend-in-cycles.md
index 5f448eb..071511b 100644
--- a/protocol/reservation-ttl-grace-period-and-extend-in-cycles.md
+++ b/protocol/reservation-ttl-grace-period-and-extend-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Reservation TTL, Grace Period, and Extend in Cycles"
+description: "How reservation time-to-live, grace periods, and the extend operation prevent phantom budget consumption in Cycles."
+---
+
 # Reservation TTL, Grace Period, and Extend in Cycles
 
 Reservations in Cycles do not live forever.
diff --git a/protocol/standard-metrics-and-metadata-in-cycles.md b/protocol/standard-metrics-and-metadata-in-cycles.md
index 8c8841e..a603bc7 100644
--- a/protocol/standard-metrics-and-metadata-in-cycles.md
+++ b/protocol/standard-metrics-and-metadata-in-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "Standard Metrics and Metadata in Cycles"
+description: "Attach execution metrics and custom metadata to commits and events in Cycles for debugging and analytics."
+---
+
 # Standard Metrics and Metadata in Cycles
 
 Budget enforcement tells you whether work is allowed and how much it costs.
diff --git a/protocol/understanding-units-in-cycles-usd-microcents-tokens-credits-and-risk-points.md b/protocol/understanding-units-in-cycles-usd-microcents-tokens-credits-and-risk-points.md
index 228f4af..73b89c6 100644
--- a/protocol/understanding-units-in-cycles-usd-microcents-tokens-credits-and-risk-points.md
+++ b/protocol/understanding-units-in-cycles-usd-microcents-tokens-credits-and-risk-points.md
@@ -1,3 +1,8 @@
+---
+title: "Understanding Units in Cycles: USD_MICROCENTS, TOKENS, CREDITS, and RISK_POINTS"
+description: "Reference for the four standard unit types in Cycles and how they affect budget expression, estimation, and ledger interpretation."
+---
+
 # Understanding Units in Cycles: USD_MICROCENTS, TOKENS, CREDITS, and RISK_POINTS
 
 Every amount in Cycles — reservations, commits, events, balances — has a unit.
diff --git a/public/robots.txt b/public/robots.txt
new file mode 100644
index 0000000..ff65e93
--- /dev/null
+++ b/public/robots.txt
@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://runcycles.io/sitemap.xml
diff --git a/quickstart/architecture-overview-how-cycles-fits-together.md b/quickstart/architecture-overview-how-cycles-fits-together.md
index 3551e5a..610aa60 100644
--- a/quickstart/architecture-overview-how-cycles-fits-together.md
+++ b/quickstart/architecture-overview-how-cycles-fits-together.md
@@ -1,3 +1,8 @@
+---
+title: "Architecture Overview: How Cycles Fits Together"
+description: "Learn how Cycles components interact — the protocol, server, admin server, and Spring Boot starter — and how budget enforcement flows through the system."
+---
+
 # Architecture Overview: How Cycles Fits Together
 
 Cycles is a budget authority for autonomous execution. It sits between your application and the actions that cost money or carry risk.
diff --git a/quickstart/deploying-the-full-cycles-stack.md b/quickstart/deploying-the-full-cycles-stack.md
index 66f32c5..8b71fed 100644
--- a/quickstart/deploying-the-full-cycles-stack.md
+++ b/quickstart/deploying-the-full-cycles-stack.md
@@ -1,3 +1,8 @@
+---
+title: "Deploying the Full Cycles Stack"
+description: "Deploy the Cycles server, admin server, and Redis from zero to a working budget enforcement stack with Docker Compose or from source."
+---
+
 # Deploying the Full Cycles Stack
 
 This guide walks you from zero to a working Cycles deployment. By the end, you will have budget enforcement running and verified with a real reserve-commit cycle.
diff --git a/quickstart/end-to-end-tutorial.md b/quickstart/end-to-end-tutorial.md
index 201a480..c2aadc7 100644
--- a/quickstart/end-to-end-tutorial.md
+++ b/quickstart/end-to-end-tutorial.md
@@ -1,3 +1,8 @@
+---
+title: "End-to-End Tutorial: Zero to Budget-Guarded LLM Call"
+description: "Go from zero to a working budget-guarded OpenAI call in 10 minutes by deploying Cycles, creating a tenant, funding a budget, and making your first LLM call."
+---
+
 # End-to-End Tutorial: Zero to Budget-Guarded LLM Call
 
 This tutorial takes you from nothing to a working budget-guarded OpenAI call in about 10 minutes. You will deploy the Cycles stack, create a tenant, fund a budget, and make your first budget-enforced LLM call.
diff --git a/quickstart/getting-started-with-the-cycles-spring-boot-starter.md b/quickstart/getting-started-with-the-cycles-spring-boot-starter.md
index aeecbfa..23df9a3 100644
--- a/quickstart/getting-started-with-the-cycles-spring-boot-starter.md
+++ b/quickstart/getting-started-with-the-cycles-spring-boot-starter.md
@@ -1,3 +1,8 @@
+---
+title: "Getting Started with the Cycles Spring Boot Starter"
+description: "Integrate budget enforcement into Spring Boot apps using the @Cycles annotation for automatic reserve, commit, and release lifecycle management."
+---
+
 # Getting Started with the Cycles Spring Boot Starter
 
 The Cycles Spring Boot Starter provides a declarative way to add budget enforcement to any Spring application.
diff --git a/quickstart/getting-started-with-the-python-client.md b/quickstart/getting-started-with-the-python-client.md
index 9ceee4c..80cb7e4 100644
--- a/quickstart/getting-started-with-the-python-client.md
+++ b/quickstart/getting-started-with-the-python-client.md
@@ -1,3 +1,8 @@
+---
+title: "Getting Started with the Python Client"
+description: "Add budget enforcement to Python apps using the runcycles package with the @cycles decorator, async support, and programmatic CyclesClient."
+---
+
 # Getting Started with the Python Client
 
 The `runcycles` Python package provides both a `@cycles` decorator and a programmatic `CyclesClient` for adding budget enforcement to any Python application.
diff --git a/quickstart/getting-started-with-the-typescript-client.md b/quickstart/getting-started-with-the-typescript-client.md
index 7905540..8407c84 100644
--- a/quickstart/getting-started-with-the-typescript-client.md
+++ b/quickstart/getting-started-with-the-typescript-client.md
@@ -1,3 +1,8 @@
+---
+title: "Getting Started with the TypeScript Client"
+description: "Add budget enforcement to Node.js apps using the runcycles TypeScript package with the withCycles HOF, streaming support, and programmatic client."
+---
+
 # Getting Started with the TypeScript Client
 
 The `runcycles` TypeScript package provides a `withCycles` higher-order function, a `reserveForStream` streaming adapter, and a programmatic `CyclesClient` for adding budget enforcement to any Node.js application.
diff --git a/quickstart/how-to-add-hard-budget-limits-to-spring-ai-with-cycles.md b/quickstart/how-to-add-hard-budget-limits-to-spring-ai-with-cycles.md
index cd25dff..259084e 100644
--- a/quickstart/how-to-add-hard-budget-limits-to-spring-ai-with-cycles.md
+++ b/quickstart/how-to-add-hard-budget-limits-to-spring-ai-with-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "How to Add Hard Budget Limits to Spring AI with Cycles"
+description: "Add pre-execution budget enforcement to Spring AI applications using the Cycles reserve-commit lifecycle for model calls, tools, and agent loops."
+---
+
 # How to Add Hard Budget Limits to Spring AI with Cycles
 
 Most AI applications start with observability.
diff --git a/quickstart/how-to-choose-a-first-cycles-rollout-tenant-budgets-run-budgets-or-model-call-guardrails.md b/quickstart/how-to-choose-a-first-cycles-rollout-tenant-budgets-run-budgets-or-model-call-guardrails.md
index 46f7a17..7c33cd9 100644
--- a/quickstart/how-to-choose-a-first-cycles-rollout-tenant-budgets-run-budgets-or-model-call-guardrails.md
+++ b/quickstart/how-to-choose-a-first-cycles-rollout-tenant-budgets-run-budgets-or-model-call-guardrails.md
@@ -1,3 +1,8 @@
+---
+title: "How to Choose a First Cycles Rollout: Tenant Budgets, Run Budgets, or Model-Call Guardrails?"
+description: "Decide where to start with Cycles: tenant budgets for cost isolation, run budgets for runaway prevention, or model-call guardrails for low-friction adoption."
+---
+
 # How to Choose a First Cycles Rollout: Tenant Budgets, Run Budgets, or Model-Call Guardrails?
 
 One of the first questions teams ask after understanding Cycles is:
diff --git a/quickstart/self-hosting-the-cycles-server.md b/quickstart/self-hosting-the-cycles-server.md
index d6f819c..8ba99fa 100644
--- a/quickstart/self-hosting-the-cycles-server.md
+++ b/quickstart/self-hosting-the-cycles-server.md
@@ -1,3 +1,8 @@
+---
+title: "Self-Hosting the Cycles Server"
+description: "Run the Cycles budget enforcement server locally, with Docker, or in production. Covers configuration, Redis setup, scaling, and health checks."
+---
+
 # Self-Hosting the Cycles Server
 
 The Cycles server is a Spring Boot application that enforces budget reservations backed by Redis. This guide covers how to run it locally, with Docker, and in production.
diff --git a/quickstart/what-is-cycles.md b/quickstart/what-is-cycles.md
index 51dbc7e..46b174c 100644
--- a/quickstart/what-is-cycles.md
+++ b/quickstart/what-is-cycles.md
@@ -1,3 +1,8 @@
+---
+title: "What is Cycles?"
+description: "Cycles is a budget authority for autonomous execution that enforces hard spend limits on AI agents and workflows before expensive actions happen."
+---
+
 # What is Cycles?
 
 Cycles is a **budget authority for autonomous execution**. It enforces hard spend limits on AI agents and autonomous workflows *before* expensive actions happen — not after.