Vibe Coding: cómo escribir criterios de aceptación para validar un MVP
Imagina que estás construyendo una aplicación para reservar citas y le pides a una herramienta de inteligencia artificial que implemente el calendario, la disponibilidad y la confirmación por correo. La IA genera una primera versión, pero aparece una duda importante: ¿cómo sabes que la función realmente cumple lo que necesita tu negocio?
Antes de pedir más código, conviene convertir la idea en comportamientos comprobables. Para eso sirven los criterios de aceptación: reglas concretas que permiten verificar si una función del MVP está lista, qué debe ocurrir en condiciones normales y cómo debe responder ante errores o casos límite.
En este artículo aprenderás a escribir criterios de aceptación para una función de reserva de citas, a expresarlos con el formato Dado/Cuando/Entonces y a realizar una revisión manual sencilla sin confundir criterios, prompts y pruebas automatizadas.
Qué problema resuelven los criterios de aceptación al crear un MVP con IA
Cuando una persona describe una función con frases como “necesito que los usuarios puedan reservar una cita”, todavía quedan muchas decisiones sin definir:
- ¿Qué horarios están disponibles?
- ¿Se puede reservar una hora que ya eligió otra persona?
- ¿Qué datos son obligatorios?
- ¿Qué ocurre si el correo electrónico no es válido?
- ¿Se puede reservar en una fecha pasada?
- ¿Cómo sabe el usuario que la reserva se completó?
Si estas reglas no están claras, la IA puede generar una implementación técnicamente válida, pero diferente de lo que esperabas. El problema no siempre estará en el código: puede estar en que la solicitud original no definía el comportamiento esperado.
Los criterios de aceptación funcionan como un acuerdo práctico entre la necesidad del negocio y la solución construida. No describen todos los detalles internos de la aplicación. Describen qué debe poder observar y comprobar una persona usuaria.
Una función no está definida solo por su pantalla
Una interfaz puede mostrar un calendario atractivo y un botón de “Reservar”, pero eso no garantiza que la función esté completa. También debes comprobar las reglas que ocurren detrás:
- La aplicación solo permite elegir horarios disponibles.
- Los campos obligatorios se validan antes de enviar la solicitud.
- Una cita confirmada deja de aparecer como disponible.
- El usuario recibe una confirmación clara.
- Los errores explican qué debe corregirse.
Cómo convertir una idea de MVP en comportamientos comprobables
Una forma sencilla de comenzar es dividir la función en cinco elementos:
- Actor: quién realiza la acción, por ejemplo, una persona que quiere reservar.
- Condición inicial: qué debe ser cierto antes de empezar.
- Acción: qué hace la persona usuaria.
- Resultado esperado: qué debe ocurrir si todo es correcto.
- Respuesta ante errores: qué debe pasar cuando los datos o las condiciones no son válidos.
Por ejemplo, la frase “el usuario puede reservar una cita” puede transformarse en una regla verificable:
Una persona puede seleccionar un horario disponible, introducir sus datos obligatorios y confirmar una cita. Después de una confirmación exitosa, el horario ya no puede reservarse nuevamente.
Esta formulación es más útil porque incluye el flujo principal y una consecuencia importante: evitar reservas duplicadas.
Define primero las reglas del negocio
Antes de pedirle a la IA que genere componentes, endpoints o bases de datos, escribe las reglas que no deberían quedar a interpretación. En una reserva de citas podrían ser:
- Solo se muestran horarios dentro del horario de atención.
- No se pueden reservar fechas pasadas.
- El nombre y el correo electrónico son obligatorios.
- Un horario no puede tener dos reservas confirmadas.
- Una reserva exitosa muestra un resumen con la fecha y la hora.
- Si ocurre un error, la información introducida no se pierde sin explicación.
No necesitas conocer todavía si la solución usará una API en Node.js, un backend en Java o una base de datos concreta. En esta etapa estás definiendo el comportamiento que la implementación debe cumplir.
Ejemplos de criterios de aceptación con Dado, Cuando y Entonces
El formato Dado/Cuando/Entonces ayuda a escribir escenarios claros:
- Dado: describe el contexto inicial.
- Cuando: describe la acción realizada.
- Entonces: describe el resultado esperado.
No es necesario utilizar una herramienta especializada. Puedes escribirlos en un documento, una hoja de cálculo o una tarea de tu proyecto.
Escenario 1: reservar un horario disponible
Dado que existe un horario disponible para el 15 de mayo a las 10:00,
Cuando la persona introduce su nombre y un correo electrónico válido, selecciona ese horario y confirma la reserva,
Entonces la aplicación crea la reserva y muestra un mensaje con la fecha, la hora y los datos principales de la cita.
Escenario 2: impedir una reserva duplicada
Dado que el horario del 15 de mayo a las 10:00 ya tiene una reserva confirmada,
Cuando otra persona intenta seleccionar o confirmar ese mismo horario,
Entonces la aplicación impide la reserva y muestra que el horario ya no está disponible.
Este caso es especialmente importante. No basta con ocultar visualmente el horario después de una reserva. Si varias personas usan la aplicación casi al mismo tiempo, la validación también debe realizarse en el momento de confirmar la operación.
Escenario 3: datos obligatorios incompletos
Dado que la persona ha seleccionado un horario disponible,
Cuando intenta confirmar la reserva sin introducir su nombre,
Entonces la aplicación no crea la cita y señala que el nombre es obligatorio.
Escenario 4: correo electrónico no válido
Dado que la persona ha seleccionado un horario,
Cuando introduce un correo electrónico con un formato inválido y envía el formulario,
Entonces la aplicación no confirma la reserva y solicita corregir el correo electrónico.
Escenario 5: fecha no permitida
Dado que la aplicación permite reservar únicamente fechas actuales o futuras,
Cuando la persona intenta reservar una fecha pasada,
Entonces la aplicación rechaza la operación y explica que debe elegir una fecha válida.
Qué debe incluir una validación completa de la reserva
Un MVP no necesita cubrir todos los escenarios posibles del negocio, pero sí debe proteger el flujo principal y los errores que podrían generar confusión o pérdida de información.
Datos de entrada
Comprueba que los campos obligatorios estén claramente identificados y que la aplicación valide su contenido. Por ejemplo:
- El nombre no puede quedar vacío.
- El correo debe tener un formato aceptable.
- Debe existir una fecha seleccionada.
- Debe existir un horario seleccionado.
También conviene decidir qué ocurre con valores inusuales, como espacios en blanco, nombres demasiado largos o un correo con espacios adicionales. No todos estos casos tienen que resolverse en la primera versión, pero deben considerarse si afectan la experiencia o la integridad de la reserva.
Disponibilidad y concurrencia
La disponibilidad debe comprobarse tanto al mostrar los horarios como al confirmar la reserva. Entre ambos momentos, otra persona podría ocupar el mismo horario.
Por eso, un criterio útil es:
La aplicación no confirma una reserva si el horario dejó de estar disponible después de que la persona lo seleccionó.
La implementación concreta puede variar, pero el comportamiento esperado debe ser claro. La interfaz no debería informar que una cita fue creada si el sistema no pudo guardarla correctamente.
Confirmaciones y errores
Una confirmación útil debe permitir responder rápidamente a estas preguntas:
- ¿La reserva se creó realmente?
- ¿Qué fecha y hora se reservaron?
- ¿Qué nombre o correo se asociaron a la cita?
- ¿Qué debe hacer la persona si necesita cambiarla?
En caso de error, el mensaje debe ser comprensible y estar relacionado con la acción que falló. “Error interno” puede ser técnicamente cierto, pero no ayuda a la persona usuaria a decidir el siguiente paso.
Criterios de aceptación, prompts y pruebas automatizadas: no son lo mismo
Estos tres elementos pueden relacionarse, pero cumplen funciones diferentes.
Criterios de aceptación
Describen qué comportamiento debe cumplirse para considerar terminada una función. Están orientados al resultado del producto y pueden ser entendidos por una persona de negocio, diseño, desarrollo o QA.
Ejemplo:
Si un horario ya fue reservado, otra persona no puede confirmar una nueva reserva para ese mismo horario.
Prompts para la IA
Indican a la herramienta de IA qué quieres que construya o modifique. Un prompt puede incluir criterios de aceptación, contexto, restricciones y una solicitud técnica.
Por ejemplo:
Implementa el flujo de reserva de citas. La reserva debe exigir nombre y correo válidos, impedir horarios ocupados y mostrar una confirmación con la fecha y hora. Antes de escribir código, resume cómo comprobarás cada criterio.
El prompt orienta la generación. No demuestra que el resultado funcione.
Pruebas automatizadas
Son verificaciones ejecutables que comprueban el comportamiento de forma repetible. Pueden probar una función, un endpoint o un flujo completo, dependiendo de cómo esté construida la aplicación.
Una prueba automatizada podría comprobar que una segunda solicitud para el mismo horario recibe una respuesta de rechazo. Sin embargo, para crearla necesitas haber definido antes qué significa “rechazo”, qué respuesta esperas y qué estado debe conservar el sistema.
Los criterios de aceptación pueden convertirse en pruebas manuales, pruebas automatizadas o ambas. No son código por sí mismos, pero sirven como referencia para decidir qué código y qué verificaciones hacen falta.
Cómo hacer una revisión manual antes de pedir más código
Una revisión manual pequeña puede detectar ambigüedades antes de que el MVP crezca. No necesitas probar toda la aplicación en una sola sesión. Elige el flujo principal y recórrelo como lo haría una persona usuaria.
Lista de comprobación para el flujo principal
- ¿Se puede identificar fácilmente qué horarios están disponibles?
- ¿La aplicación impide avanzar cuando falta un dato obligatorio?
- ¿El mensaje de validación indica qué debe corregirse?
- ¿La reserva confirmada muestra la información correcta?
- ¿El horario reservado deja de estar disponible?
- ¿Se evita crear una segunda reserva para el mismo horario?
- ¿La aplicación responde de forma comprensible si ocurre un error?
Prueba tres recorridos diferentes
Como mínimo, revisa estos recorridos:
- Camino feliz: se elige un horario disponible, se completan datos válidos y la reserva se confirma.
- Error de entrada: falta un dato o el correo no es válido, por lo que la reserva no debe crearse.
- Caso límite: se intenta reservar un horario ocupado, una fecha pasada o una opción que acaba de dejar de estar disponible.
Registra el resultado de cada escenario con una indicación simple: cumple, no cumple o necesita aclaración. Esta última categoría es importante: si no sabes qué resultado esperar, probablemente el criterio todavía no está suficientemente definido.
Errores frecuentes al validar funciones generadas con IA
Escribir criterios demasiado generales
“La reserva debe funcionar correctamente” no permite saber qué revisar. Sustitúyelo por comportamientos observables, como “la aplicación muestra un resumen con la fecha y la hora después de una reserva exitosa”.
Describir solo la interfaz
Que un horario desaparezca de la pantalla no demuestra que la reserva se haya guardado. También debes verificar la operación que sostiene esa pantalla: disponibilidad, confirmación y manejo de errores.
Probar únicamente el camino feliz
Una función puede funcionar con datos perfectos y fallar cuando falta un campo, se utiliza una fecha pasada o dos personas intentan reservar el mismo horario. Los casos de error forman parte del comportamiento del MVP.
Pedir cambios a la IA sin comprobar el resultado anterior
Si continúas solicitando nuevas funcionalidades sin validar la anterior, puedes acumular comportamientos contradictorios. Después de cada cambio relevante, repasa los criterios existentes para confirmar que siguen cumpliéndose.
Confundir una explicación convincente con una validación
La IA puede describir correctamente cómo debería funcionar una solución y aun así generar código incompleto. La explicación ayuda a revisar el enfoque, pero la comprobación debe hacerse sobre la aplicación y, cuando corresponda, mediante pruebas repetibles.
Conclusión: valida el comportamiento antes de ampliar tu MVP
El Vibe Coding permite avanzar rápidamente con ayuda de la IA, pero esa velocidad también puede aumentar la ambigüedad. Los criterios de aceptación ayudan a mantener el foco en lo que realmente debe hacer el producto, sin exigir que conozcas todos los detalles técnicos de su implementación.
Para una función como la reserva de citas, empieza por definir el flujo exitoso, los datos obligatorios, las reglas de disponibilidad, las confirmaciones y algunos casos límite. Escríbelos con frases observables o con el formato Dado/Cuando/Entonces. Después, realiza una revisión manual y decide qué escenarios conviene automatizar.
Antes de ampliar tu MVP, escribe tres criterios de aceptación para su función principal y comprueba que se cumplen. Esta práctica sencilla puede ayudarte a pedir mejores cambios a la IA y a detectar problemas antes de construir nuevas partes de la aplicación.
