Newsletter para devsEntra

Pre-mortem: adelántate a los fallos preguntando qué puede salir mal

Una skill que te hace leer el post-mortem de tu propio cambio antes de tocar el primer fichero. Tres a cinco modos de fallo ordenados por peligro, con la mitigación mínima para cada uno, y una recomendación sin tibieza: ship, endurece o parte el cambio.

Invócala con un comando

  • /pre-mortem "migrar la tabla de pagos al nuevo esquema"

    Te devuelve el cambio en una frase, 3-5 modos de fallo ordenados por likelihood × blast radius (escenario, probabilidad, blast, mitigación concreta) y una recomendación cerrada: ship as-is, harden first o split the change.

  • /pre-mortem "el PR #482 refactoriza el checkout a Stripe Elements"

    Pega el PR o el diff: la skill se centra en el cambio concreto, no en el producto entero, y descarta de raíz lo que ya tienen cobertura de tests.

Qué es esta skill

¿Qué es pre-mortem?

pre-mortem te obliga a leer el post-mortem de tu propio cambio antes de tocar el primer fichero. Imagina que ya está en producción y roto: ¿qué dice el informe de la mañana siguiente?

Los bugs más caros no nacen de ignorancia, nacen de confianza incompleta. Asumir que el tiempo va en minutos cuando la API lo da en segundos, dos webhooks de Stripe llegando en 200ms, una migración que rompe jobs en vuelo, un DialogTitle que alguien dependía y el refactor se ha cargado de paso. Cada uno era evitable con cinco minutos de “¿cómo puede fallar esto?”. La skill convierte esos cinco minutos en disciplina.

Se llama como el ejercicio de Gary Klein: en vez de “por qué podría salir bien”, la pregunta es “por qué ha salido mal” — escrita en pasado, con un culpable claro. Esa flexión mental desbloquea fallos que el optimismo del planning oculta.

Cómo funciona

Qué hace con tu plan

La skill toma un plan, un diff o un PR aprobado y produce exactamente esto, en este orden:

  • El cambio en una frase. Si no puedes resumirlo en una frase, el cambio es demasiado grande para razonar sobre él: la propia skill te recomendará partirlo antes de seguir.
  • 3-5 modos de fallo. Cada uno con cuatro campos: escenario concreto (con actores, timings, filas — no “podría ir lento”), likelihood High/Medium/Low con justificación anclada a tu código y tus usuarios, blast radius con números (usuarios, dólares, requests) y la mitigación mínima que lo evita (índice único, feature flag, dry-run, idempotency key, rollback, un test que lo habría cazado).
  • Una recomendación cerrada. Sin tibieza: ship as-is, harden first o split the change. Un “igual sí, igual no” no es respuesta válida — el punto de la skill es forzar la decisión mientras cambiar de rumbo todavía es barato.

Los modos van ordenados por likelihood × blast radius, los más peligrosos primero. Si con un cambio no trivial sólo se te ocurren dos modos creíbles, probablemente estás anclado al happy path: vuelve al diff con la pregunta “¿qué está asumiendo implícitamente este cambio?” y mira unidades, timezones, orden de escrituras, idempotencia, qué pasa al reintentar, qué pasa si el usuario cierra la pestaña, cuál era el estado previo de la BD.

Cuándo NO usarla

Cuándo NO usarla

La disciplina mata el ritmo si la aplicas a todo. La propia skill lo dice y es honesto repetirlo: no corras un pre-mortem sobre un cambio de una línea, un rename, un fix de tipos o un refactor con cobertura de tests completa — los tests ya son el pre-mortem. Tampoco en prototipos donde el objetivo es aprender, no enviar a producción con seguridad.

La regla que la skill propone: “¿te pagaría que te pagaran las 3am por esto?”. Si sí, corre el pre-mortem. Si no, envía y ya.

Instalación

Cómo instalar pre-mortem

Funciona con cualquier agente compatible con el estándar abierto de Agent Skills (Claude Code, Cursor, Codex, OpenCode, Gemini CLI…). Pega esto en tu terminal y listo:

npx skills add webreactiva/skills --skill pre-mortem

¿La quieres disponible en todos tus proyectos? Añade -g para instalarla global en la carpeta de skills de tu agente (~/.agents/skills, o ~/.claude/skills si usas Claude Code):

npx skills add webreactiva/skills --skill pre-mortem -g

Es open source. Puedes ver el código fuente en GitHub antes de instalarla.

Preguntas frecuentes

¿En qué idioma me responde?

En el que le escribas. Si le pasas el plan o el PR en español, te devuelve el pre-mortem en español; si lo pegas en inglés, en inglés. La salida sigue el mismo esquema en ambos casos: cambio en una frase, 3-5 modos de fallo y recomendación cerrada.

¿Necesito tener un plan escrito para usarla?

Sí, ese es el punto. La skill se aplica entre “plan aprobado” y “primer commit”: necesita algo concreto que revisar (un plan, un diff, un PR). Si el problema todavía es difuso, la propia skill te dirá que primero hay que aterrizar qué estás cambiando — diagnosticar el problema equivocado es un modo de fallo más caro que los que la skill caza.

¿Con qué agentes funciona?

Con cualquiera compatible con el estándar abierto de Agent Skills: Claude Code, Cursor, OpenAI Codex, OpenCode, Gemini CLI y más. La instalas una vez y la usas donde quieras.

¿Tiene coste?

Es open source. La descargas e instalas gratis; el código está en GitHub.

¿Cómo se usa?

No necesitas el comando: tu agente también la activa sola cuando le dices algo como…

  • haz un pre-mortem de este cambio
  • qué podría romperse con esto
  • qué puede salir mal
  • pre-mortem del plan
  • premortem this plan
  • what could break
  • failure modes for this change

Siguiente paso

Ya sabes instalar skills. Aprende a crearlas.

Si te ha gustado tener un copiloto a demanda, el siguiente paso es escribir las tuyas. En la guía de skills aprendes la anatomía de un SKILL.md, a redactar descripciones que la disparan sola y a validarla.

Ir a la guía de skills →