- Inicio
- Plantillas
- Plantilla de postmortem de incidente para un cambio escrito por IA
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
| Pregunta | Respuesta |
|---|---|
| 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.
| Hora | Qué pasó |
|---|---|
| HH:MM | Se da la tarea a la herramienta |
| HH:MM | Se abre el pull request |
| HH:MM | Lo aprueba [rol] |
| HH:MM | Se fusiona y se despliega |
| HH:MM | Primera señal del problema: [alerta, ticket, usuario] |
| HH:MM | Se declara el incidente |
| HH:MM | Mitigado: [revert, flag desactivado, rollback] |
| HH:MM | Resuelto |
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ón | Tipo | Responsable | Fecha límite | Ticket |
|---|---|---|---|---|
| [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.
Relacionado
- ¿Qué son los controles de calidad?
- Hacer rollback de un despliegue
- Paquetes de evidencias
- Registros de auditoría, roles y políticas para programar con IA
- Plantilla de política de programación con IA para equipos de ingeniería
- Checklist de publicación para equipos que entregan código escrito por IA
- Todas las plantillas