Runbooks
Runbooks uses Claude Code agents to plan and execute coding tasks in isolated sandboxes. Describe what you want, review the generated spec, and let agents implement it.
Why Runbooks
Individual AI tools like Claude Code are powerful but create challenges at team scale: conversations disappear when you close the session, each developer gets different solutions to the same problem, and implementation knowledge stays siloed.
Runbooks solves this with three capabilities:
Multiplayer AI: Multiple developers collaborate in shared sessions. Experienced AI engineers guide others on using better prompts, teams align on approaches together, and everyone sees the AI's reasoning. No more inconsistent patterns from isolated AI conversations.
Persistent knowledge: Every solution becomes an organizational asset. Context files teach agents your codebase patterns. Successful runbooks become templates that capture proven workflows. New team members leverage accumulated knowledge immediately.
Spec-driven execution: Review and approve plans before any code changes. Step-by-step execution with clear milestones replaces ad-hoc prompting. Standardized templates ensure consistent approaches across teams.
Quick start
Review and refine the generated plan
Execute steps and merge the resulting PRs
How it works
Planning: Describe your task in the chat interface. Agents analyze your codebase, gather context, and generate a step-by-step plan.
Execution: Run the plan step-by-step with review at each stage, or use one-shot mode for simpler tasks.
Collaboration: Invite team members to review plans, provide feedback, and assign steps.
Sandboxes
Agents execute in isolated environments with your codebase:
Cloud sandboxes - Managed by Aviator, no setup required
SSH sandboxes - Self-hosted on your infrastructure
Use cases
Code migrations - Framework upgrades, API changes
Bug fixes - Investigate and fix issues
Refactoring - Improve code structure
Test coverage - Add missing tests
Flaky tests - Fix unreliable tests
Build optimization - Speed up CI
Configuration
Context files - Help agents understand your codebase
MCP servers - Add custom tool integrations
Tool permissions - Control agent capabilities
Personas - Customize agent behavior
Templates - Reuse runbooks across tasks
Prerequisites
GitHub account with repository access
Runbooks access (cloud or on-premise)
Last updated
Was this helpful?
