DEV Community

Serguey Shinder
Serguey Shinder

Posted on

El caos que no documentas lo repites

El caos que no documentas, lo repites. Lo aprendí resolviendo, por tercera vez, el mismo incidente que ya había resuelto dos veces antes, sin recordar cómo lo había arreglado ninguna de las dos.

En operaciones, la memoria es traicionera. Apagas un fuego a las tres de la madrugada, sientes el alivio, y sigues con tu vida. Meses después, el mismo fuego vuelve, y descubres que todo lo que aprendiste aquella noche se ha esfumado. No quedó nada: ni qué lo causó, ni qué probaste, ni qué acabó funcionando. Vuelves a empezar de cero, cansado y con prisa, cometiendo los mismos errores.

Un runbook, una guía sencilla de qué hacer cuando algo pasa, rompe ese ciclo. No es burocracia; es memoria que sobrevive a la persona. La siguiente vez que algo falla, quien esté de guardia no improvisa a las tres de la madrugada: sigue unos pasos que alguien, con la cabeza fría, ya pensó por él.

Lo mismo vale para los postmortems. Cuando un incidente termina, la tentación es olvidarlo cuanto antes; duele revisarlo. Pero ese es justo el momento en que más sabes sobre lo que salió mal. Escribirlo, sin buscar culpables, convierte un mal día en una lección que el equipo entero conserva.

Documentar no es lo glamuroso del oficio. Nadie presume de sus runbooks. Pero la diferencia entre un equipo que mejora y uno que sufre el mismo incidente una y otra vez casi siempre es esa: uno escribió lo que aprendió, y el otro confió en que lo recordaría. Nunca lo recuerdas.

– Serguey Shinder

Top comments (0)