Skip to content

The Runbook

Turbot HQ's internal institutional knowledge base.

What Is This?

The Runbook captures what Turbot HQ specifically did, decided, and why. It is not a product manual. It is not a tutorial. It is institutional memory.

The golden rule: If a Turbot customer would find it useful → it belongs in product docs. If it is specific to Turbot HQ's setup, decisions, or history → it belongs here.

Built By LLM, For LLM

This runbook is designed to be authored through LLM-assisted brain-dump conversations and structured for LLM retrieval. Every page follows a consistent schema so that an LLM can reliably extract facts, decisions, and context without needing surrounding pages for disambiguation.

When contributing, follow the page structure defined in .skills/runbook-contributor/SKILL.md.

Connecting Your LLM Tools

The runbook exposes an MCP (Model Context Protocol) server at https://runbook.turbot.com/api/mcp. Add it to your Claude Code config (~/.claude/settings.json) once and it becomes ambient context in every session — no more manually finding and pasting pages.

{
  "mcpServers": {
    "runbook": {
      "type": "http",
      "url": "https://runbook.turbot.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Get YOUR_API_KEY from 1Password → Turbot Internal Tools. Once connected, you can ask Claude things like "search the runbook for AWS SSO" or "get the ops log page for EventBridge" and it will pull the answer directly from here.

See MCP Server Tooling for full setup, available tools, and operational details.

Last Updated

2026-04-04 — Venu