Runbook

Procedimiento operacional reproducible paso-a-paso. Un humano con acceso básico al sistema debería poder ejecutarlo sin conocimiento previo del contexto.

Ejemplos típicos: rotar una private key, revocar un PAT comprometido, recuperar un release fallido, hacer rollback de un deploy.

Cuándo se escribe

• Después de resolver un incidente que podría repetirse
• Cuando se automatiza algo y hace falta documentar el override manual
• Cuando un proceso lo hace solo una persona y necesita existir fuera de su cabeza

Qué NO es un runbook

• Una decisión técnica → eso es un ADR
• Un tutorial de arranque → eso va en el producto correspondiente
• Un post-mortem → eso es otro tipo de documento (posible sección futura)

En este sitio

Viven en /docs/runbooks/.