Overview

DevOps Runbooks crafts actionable runbooks for operational procedures, incident response, and system maintenance. It documents escalation paths, troubleshooting guides, rollback procedures, and captures essential operational knowledge to improve recovery time and consistency.

How This Skill Works

It generates a structured runbook document following a standard template (Overview, Prerequisites, Quick Reference, Procedure, Rollback, Troubleshooting, Escalation). It emphasizes copy-pasteable commands with expected outputs and clear decision points to ensure repeatable execution.

When to Use It

• Incident response planning
• On-call documentation
• System maintenance procedures
• Disaster recovery planning
• Knowledge transfer

Quick Start

1. Step 1: Reference references/RUNBOOK.template.md to ensure standard structure
2. Step 2: Fill sections (Overview, Prerequisites, Quick Reference, Procedure, Rollback, Troubleshooting, Escalation) with copy-pasteable commands and expected outputs
3. Step 3: Validate by running the procedure in a staging environment and updating outputs and rollback steps accordingly

Best Practices

• Commands must be copy-pasteable
• Include expected output for each step
• Document decision points clearly
• Define rollback at each step
• Include escalation contacts

Example Use Cases

• Incident response runbook for service outage
• On-call escalation flow for database failover
• Maintenance runbook for patching and reboot
• Disaster recovery runbook for regional outage
• Knowledge transfer guide for new SREs

Frequently Asked Questions