Ir al contenido principal

Glosario de IA Operations

¿Qué es una especificación ejecutable?

Especificación ejecutable (Executable Specification)

← Todos los términos del glosario
En pocas palabras

Especificación lo bastante precisa para ejecutarse, de modo que genera o guía pruebas, simulaciones o código sin traducción manual.

Explicación

Una especificación ejecutable es una descripción del comportamiento requerido escrita con tanta precisión que una máquina puede comprobarla o actuar sobre ella. En lugar de un documento que alguien lee y después traduce a pruebas, la propia especificación se ejecuta: ejemplos concretos ligados a código de prueba, esquemas que validan datos, contratos que comprueban una API o restricciones que acotan lo que puede devolver un modelo de lenguaje. Une la intención humana con la automatización, reduce la ambigüedad y mantiene especificación y sistema alineados. En el desarrollo guiado por especificaciones y asistido por IA, es lo que permite verificar el código generado contra lo que de verdad se pidió.

Formas habituales

  • Escenarios en formato Given-When-Then (Gherkin), ligados a step definitions que los ejecutan como pruebas de aceptación automáticas.
  • Especificación mediante ejemplos: tablas de entradas concretas y salidas esperadas acordadas con negocio.
  • Esquemas y contratos, como JSON Schema u OpenAPI, que validan datos e interfaces de forma automática.
  • Pruebas basadas en propiedades, que enuncian reglas que el sistema debe cumplir siempre y generan casos para comprobarlas.
  • En funciones con LLM, esquemas de salida estructurada y casos de evaluación que cada respuesta debe superar.

Por qué importa

Las especificaciones normales se desvían: el documento dice una cosa, el código hace otra y nadie se da cuenta hasta que algo se rompe. Una especificación ejecutable falla de forma visible en cuanto el sistema deja de hacer lo que describe, así que se mantiene al día.

También cambia la conversación con negocio. Es más fácil ponerse de acuerdo sobre ejemplos concretos que sobre reglas abstractas, y una vez acordados se convierten a la vez en documentación y en prueba.

Especificaciones ejecutables e IA

Cuando los agentes de IA escriben código, el cuello de botella pasa de escribir a verificar. Una especificación precisa y ejecutable da al agente un objetivo claro y al equipo una forma automática de comprobar el resultado: el código generado pasa los escenarios, esquemas y contratos, o no los pasa.

La misma idea vale para las funciones de IA. Los esquemas de salida, los conjuntos de evaluación y los criterios de aceptación escritos como comprobaciones convierten una expectativa vaga de buenas respuestas en algo que se puede probar con cada cambio.

Preguntas frecuentes

¿Qué es un ejemplo de especificación ejecutable?

Un escenario en Gherkin como este: dado un cliente con la tarjeta caducada, cuando hace un pedido, entonces se rechaza el pago y se le pide que actualice la tarjeta. Cada línea está ligada a código de prueba, así que el escenario se ejecuta contra el sistema y pasa o falla.

¿Qué es la especificación mediante ejemplos?

Es la práctica de especificar el comportamiento con ejemplos concretos en lugar de enunciados abstractos. Martin Fowler la describe como uno de los papeles de las pruebas en el desarrollo ágil: escribir primero las pruebas es usar ejemplos como especificación.

¿Qué relación tiene la especificación ejecutable con BDD?

El desarrollo guiado por comportamiento (BDD) es una de las formas principales de producir especificaciones ejecutables. Los equipos describen el comportamiento en un lenguaje compartido como Gherkin, y herramientas como Cucumber ejecutan esas descripciones como pruebas.

¿Qué diferencia hay entre una especificación ejecutable y una prueba unitaria?

Una prueba unitaria comprueba una pieza pequeña de código y la escriben los desarrolladores para sí mismos. Una especificación ejecutable describe un comportamiento que importa a negocio o a los usuarios, en términos que pueden leer, y comprueba el sistema contra él. Las dos son automáticas.

¿Por qué son útiles en el desarrollo guiado por especificaciones?

En el desarrollo guiado por especificaciones, la especificación es la fuente de la que salen el diseño, el código y las pruebas, cada vez más con ayuda de IA. Si es ejecutable, cada artefacto derivado se puede comprobar contra ella de forma automática, y así se mantienen alineados.

Guías de decisión que usan este término

Dónde aparece en Thinkia

Para seguir leyendo

Fuentes

Actualizado: 2026-10-21

¿Quieres ver cómo se aplica en tu organización?

Habla con un experto en IA