En una empresa de servicios administrados se generan documentos constantemente: SOPs, playbooks, lecciones aprendidas, procedimientos de recuperación, guías de implementación. Durante años, el principal problema no fue saber qué hacer — cualquier ingeniero con experiencia sabe cómo resolver el noventa por ciento de los incidentes recurrentes. El problema fue siempre tener tiempo para escribirlo de forma que otra persona pudiera seguirlo sin tener que preguntar.
Lo que creíamos inicialmente
Nuestra hipótesis era sencilla: la IA podría ayudarnos a escribir más rápido. Nada más. No esperábamos que pudiera producir documentación técnicamente aceptable por sí sola — la tratamos, al principio, como un procesador de texto con mejor gramática.
Lo que hicimos
Comenzamos con procedimientos relativamente simples y de bajo riesgo si algo salía mal: configuración de SNMP en dispositivos de red, instalación de agentes de monitoreo, procedimientos de respaldo rutinario, guías de actualización de firmware. Eran tareas que cualquier ingeniero junior podía ejecutar siguiendo el documento, y donde un error se notaba rápido y se corregía sin consecuencias graves.
Con el tiempo fuimos aumentando la complejidad hacia procedimientos de mayor impacto: recuperación de configuración de firewall tras una falla, restauración de backups desde un repositorio, configuración de túneles VPN site-to-site, y procedimientos completos de recuperación ante desastres — el tipo de documento que un ingeniero abre a las tres de la mañana durante un incidente real, no en un ejercicio tranquilo de laboratorio.
Lo que funcionó
La IA resultó particularmente buena en tres cosas concretas. Primero, mantener una estructura consistente entre documentos — encabezados, numeración, secciones de prerrequisitos y validación, sin que cada autor humano tuviera que recordarlas manualmente. Segundo, generar listas de verificación exhaustivas a partir de una descripción narrativa del procedimiento, capturando pasos que el redactor original daba por sentado y por eso omitía. Tercero, proponer secciones que solían faltar: qué hacer si el procedimiento falla a la mitad, cómo revertir un cambio, a quién escalar si el paso no funciona como se espera.
El efecto combinado fue una reducción real en el tiempo entre "sabemos cómo hacer esto" y "existe un documento que alguien más puede seguir sin ayuda".
Lo que no funcionó
La misma velocidad que hacía atractiva a la IA para este trabajo escondía su mayor riesgo. En más de una ocasión inventó comandos que sonaban perfectamente plausibles para una plataforma específica, pero que no existían en la versión de firmware realmente instalada. En otras, asumió una configuración de red que no correspondía a la topología real del cliente, o mezcló sintaxis de una versión de software con la de otra, generando un procedimiento que parecía coherente de principio a fin pero que fallaría exactamente en el paso donde más importa que funcione.
Descubrimos algo incómodo en el proceso: un documento generado por IA puede verse profesional — bien estructurado, con el vocabulario técnico correcto, con el formato esperado — y seguir siendo incorrecto en el detalle que realmente importa. Es un tipo de error distinto al de un documento mal escrito por una persona apurada: ese se nota a simple vista por su desorden. El error de la IA se camufla precisamente en su buena presentación.
La lección
La documentación producida por IA debe tratarse como un borrador de alta calidad, nunca como una verdad técnica lista para ejecutarse sin revisión. La validación humana sigue siendo indispensable, especialmente en los procedimientos que se ejecutan bajo presión, durante un incidente real, donde no hay margen para descubrir a mitad de la restauración que un paso está mal.
En la práctica, esto significó agregar un paso de revisión técnica obligatorio antes de que cualquier procedimiento generado o asistido por IA se marcara como vigente — la misma disciplina de "confirmar antes de asumir" que aplicamos, en otro contexto, al auditar línea por línea nuestra propia herramienta de generación de contraseñas en este mismo blog.
Conclusión práctica
La IA acelera la primera versión de la documentación. No reemplaza la revisión técnica que la convierte en algo seguro de seguir durante un incidente real.
¿Su organización tiene procedimientos que solo viven en la cabeza de algunos ingenieros? Tal vez el mejor primer proyecto de IA sea empezar a documentarlos — con revisión técnica antes de confiar en el resultado.