AI CodeOps

Plantilla de postmortem de incidente para un cambio escrito por IA

Última actualización

Una plantilla de postmortem sin culpables para incidentes causados por cambios escritos por IA: la tarea, la herramienta, las evidencias al fusionar y qué paso de revisión o control no lo detectó.

Copia esto en tu herramienta de seguimiento de incidentes o en tu wiki. Sustituye los [corchetes], borra las secciones que no necesites y borra esta nota. Mantenlo sin culpables: describe lo que hicieron las personas y las herramientas y lo que podían ver, no quién debería haberlo sabido.

  • Incidente: [ID y título breve]
  • Gravedad: [SEV1 / SEV2 / SEV3]
  • Fecha y duración: [AAAA-MM-DD, de HH:MM a HH:MM UTC]
  • Autor: [nombre]
  • Revisado por: [nombres]
  • Estado: [borrador / revisado / acciones completadas]

1. Resumen

[Dos o tres frases: qué se rompió, a quién afectó, durante cuánto tiempo y qué lo causó.]

2. Impacto

  • Usuarios o clientes afectados: [número o proporción, y cómo lo sabes]
  • Qué experimentaron: [errores, datos incorrectos, lentitud, exposición de datos]
  • Datos afectados: [ninguno / qué datos, y si alguno salió de tus sistemas]
  • Costo: [créditos, reembolsos, tiempo de ingeniería, si se conoce]

3. El cambio

PreguntaRespuesta
Pull request y commit[enlaces]
¿Cómo se escribió?[agente de programación / asistente de IA / persona]
Herramienta y modelo[nombre y versión]
La tarea que se dio a la herramienta[pégala o enlázala]
¿El cambio hizo solo lo que pedía la tarea?[sí / no: qué más hizo]
¿Quién lo pidió, y quién lo aprobó?[roles; deberían ser personas distintas]
¿Qué pruebas se ejecutaron sobre la versión fusionada?[enlace a la ejecución; ¿se omitió alguna?]
¿El diff de las pruebas borró, omitió o relajó algo?[sí / no]
Hallazgos de revisión o de seguridad abiertos al fusionar[ninguno / lista y cómo se pasaron por triaje]
¿Se editó el cambio después de aprobarse?[sí / no; ¿se volvió a aprobar?]
¿Qué vio el aprobador cuando aprobó?[las evidencias del pull request en ese momento]

4. Cronología

Todas las horas en UTC.

HoraQué pasó
HH:MMSe da la tarea a la herramienta
HH:MMSe abre el pull request
HH:MMLo aprueba [rol]
HH:MMSe fusiona y se despliega
HH:MMPrimera señal del problema: [alerta, ticket, usuario]
HH:MMSe declara el incidente
HH:MMMitigado: [revert, flag desactivado, rollback]
HH:MMResuelto

5. Causa raíz y factores que contribuyeron

Qué estaba mal en el cambio: [el defecto real, p. ej. un error que se ignoraba y se sustituía por un resultado vacío]

Por qué pasó. Para cada capa, di si podría haberlo detectado y por qué no lo hizo.

Capa¿Podría haberlo detectado?Por qué no lo hizo
La tarea[sí / no][ambigua, le faltaba una restricción]
Las comprobaciones de la herramienta[sí / no]
Pruebas[sí / no][ninguna prueba para este caso, la prueba se debilitó]
Revisión automática[sí / no][no se ejecutó, hallazgo descartado, fuera de alcance]
Revisión humana[sí / no][demasiado grande, archivo de riesgo leído por encima, autoaprobado]
Controles de calidad[sí / no][faltaba el control, el control se superó con evidencias antiguas]
Staging o canary[sí / no]
Monitorización y alertas[sí / no][cuánto tardó alguien en darse cuenta]

6. Qué salió bien

  • [p. ej. El revert fue un clic y tardó cuatro minutos.]

7. Acciones

Prefiere las acciones que cambian un sistema a las que piden a las personas que tengan más cuidado.

AcciónTipoResponsableFecha límiteTicket
[p. ej. Añadir una prueba para una respuesta vacía del servicio de origen][prueba][nombre][AAAA-MM-DD][enlace]
[p. ej. Exigir la revisión de code owners para el módulo de facturación][control o permiso][nombre][AAAA-MM-DD][enlace]
[p. ej. Añadir «sin alternativas silenciosas» a la checklist de revisión][práctica de revisión][nombre][AAAA-MM-DD][enlace]
[p. ej. Limitar el acceso de escritura del agente a sus propias ramas][configuración del agente][nombre][AAAA-MM-DD][enlace]

8. Lecciones

[¿Qué le dirías a otro equipo que usa las mismas herramientas? Un párrafo.]

Sobre esta plantilla

Esta sección solo está en la página web, no en las descargas.

El enfoque sin culpables sigue el capítulo del libro de SRE de Google Postmortem Culture: Learning from Failure, que pone el foco en «identificar las causas que contribuyeron al incidente sin acusar a ninguna persona ni a ningún equipo». La sección 3 es lo que hace esta plantilla específica de los cambios escritos por IA: necesitas saber qué podía ver el aprobador en el momento de aprobar, o no podrás distinguir un fallo de la revisión de un fallo de las evidencias.

Si usas AI CodeOps, el paquete de evidencias del cambio contiene la mayor parte de la sección 3: la tarea, los modelos, las aprobaciones, los hallazgos, las ejecuciones de pruebas y la entrega. La guía de rollback cubre el paso de mitigación de la sección 4.

Preguntas frecuentes

¿Un postmortem debería culpar a la herramienta de IA?

No más de lo que culparía a un compilador. La pregunta útil es qué parte de tu proceso dejó pasar el cambio, y qué cambiar para que el siguiente se detecte: una comprobación, un control, un permiso o un hábito de revisión.

¿Qué diferencia esta plantilla de una plantilla de postmortem normal?

La sección 3. Registra la tarea que se dio a la herramienta, el modelo y las evidencias que vio el aprobador al fusionar, para que puedas saber si falló la revisión o si las evidencias faltaban o eran erróneas.

¿Quién debería escribir el postmortem?

Alguien que participó, con el solicitante y el aprobador revisando los dos el borrador. Ninguno de ellos debería sentirse culpable; su relato de lo que vieron es la aportación más valiosa.

Cómo citar

AI CodeOps (2026). Plantilla de postmortem de incidente para un cambio escrito por IA. https://aicodeops.dev/templates/ai-change-postmortem

Esta página y sus descargas tienen licencia CC BY 4.0: cópialas y adáptalas para tu equipo, y enlaza a esta página cuando publiques tu versión.