# Runbooks Projects at AI Tinkerers

> Canonical HTML: https://aitinkerers.org/technologies/runbooks
> Markdown URL: https://aitinkerers.org/technologies/runbooks.md
> Technology record last updated: 2026-05-05T17:09:59Z
> Generated: 2026-09-21T11:43:59Z

The Runbook is your standardized, step-by-step procedure for executing routine tasks (e.g., server patching) or resolving a specific incident (e.g., database deadlock).

A Runbook is the definitive operational guide, documenting procedures to ensure consistency and reduce Mean Time to Resolution (MTTR). It captures critical Subject Matter Expert (SME) knowledge, providing clear, actionable instructions for all team members (junior to senior). This documentation covers everything from routine maintenance like SSL certificate renewal to complex incident response flows, often integrating with automation tools (e.g., Ansible, Rundeck) for faster, error-free execution. Use it to standardize your response: eliminate guesswork, enforce best practices, and scale your operations without scaling human error.

- Official technology site: https://en.wikipedia.org/wiki/Runbook
- Public AI Tinkerers demos and talks: 2
- Result page: 1 of 1

## Recent Public Talks and Demos

### [Operating an Agentic Homelab with Agent Guides](https://seattle.aitinkerers.org/talks/rsvp_wvjI8VfiuMM)

I built a multi-node homelab with layered, enterprise-grade security (passwordless auth, secrets management, host hardening) and an OpenTofu plus Ansible control plane for infrastructure and deployment. AI agents operate it instead of me clicking through consoles. In order to facilitate rapid iteration and configuration I created a new open-standard data format called Agent Guides, which are open, Skill-compatible markdown runbooks. Provisioning a new LXC, rotating credentials, or updating firewall settings are repetitive over time, but the details drift and some of the APIs have undocumented behavior, so a single prompt is unreliable and a fixed script breaks. Plain wiki runbooks aren't ideal because they go stale as soon as the environment changes. What I wanted was documented procedures an agent can follow but still improvise when it hits something unexpected. The guides for my homelab are executed primarily by agents, whose harness leaves an audit log to review afterwards, so another agent may update the guide automatically instead of rediscovering the same problem the next time.

- Event context: AI Dev Tools Track - Seattle - July 13 — 2026-07-14 — Seattle
- Public talk page: https://seattle.aitinkerers.org/talks/rsvp_wvjI8VfiuMM

### [Savvy - Automatically Create & Share Runbooks from the terminal](https://palo-alto.aitinkerers.org/talks/rsvp_yaeEqY9h8m8)

Runbooks are a critical source of knowledge that improves the bus factor for companies and facilitates a sustainable oncall rotation. However, most runbooks are manually created, out of date and often stored in Google Docs or the equivalent. Any developer who has followed one will tell you that half the time they expect it to not work and the other time it really doesn't work :) AI make automated, Reliable and easy to follow runbooks are possible

- Event context: AI Tinkerers Palo Alto - Inaugural Meetup — 2024-05-01 — Palo Alto
- Public talk page: https://palo-alto.aitinkerers.org/talks/rsvp_yaeEqY9h8m8

## Related Technologies

- [Agent](https://aitinkerers.org/technologies/agent) ([Markdown](https://aitinkerers.org/technologies/agent.md)) — 12 public demos
- [AI](https://aitinkerers.org/technologies/ai) ([Markdown](https://aitinkerers.org/technologies/ai.md)) — 55 public demos
- [Claude Code](https://aitinkerers.org/technologies/claude-code) ([Markdown](https://aitinkerers.org/technologies/claude-code.md)) — 215 public demos
- [FastMCP](https://aitinkerers.org/technologies/fastmcp) ([Markdown](https://aitinkerers.org/technologies/fastmcp.md)) — 9 public demos
- [Google Docs](https://aitinkerers.org/technologies/google-docs) ([Markdown](https://aitinkerers.org/technologies/google-docs.md)) — 2 public demos
- [Hermes Agent](https://aitinkerers.org/technologies/hermes-agent) ([Markdown](https://aitinkerers.org/technologies/hermes-agent.md)) — 1 public demo
- [llama](https://aitinkerers.org/technologies/llama) ([Markdown](https://aitinkerers.org/technologies/llama.md)) — 48 public demos
- [Markdown](https://aitinkerers.org/technologies/markdown) ([Markdown](https://aitinkerers.org/technologies/markdown.md)) — 24 public demos
- [OpenTofu](https://aitinkerers.org/technologies/opentofu) ([Markdown](https://aitinkerers.org/technologies/opentofu.md)) — 1 public demo
- [Python](https://aitinkerers.org/technologies/python) ([Markdown](https://aitinkerers.org/technologies/python.md)) — 662 public demos
- [Runtime](https://aitinkerers.org/technologies/runtime) ([Markdown](https://aitinkerers.org/technologies/runtime.md)) — 10 public demos
- [Shell](https://aitinkerers.org/technologies/shell) ([Markdown](https://aitinkerers.org/technologies/shell.md)) — 3 public demos
- [Terminal](https://aitinkerers.org/technologies/terminal) ([Markdown](https://aitinkerers.org/technologies/terminal.md)) — 3 public demos
- [the open](https://aitinkerers.org/technologies/the-open) ([Markdown](https://aitinkerers.org/technologies/the-open.md)) — 1 public demo