Apariencia
El Vibe Coding Mola Hasta Que Se Rompe — Cómo las Specs Mantienen la AI en Línea
Si has usado un agente AI para programar durante un tiempo, conoces esa sensación. Describes lo que quieres en lenguaje natural, le das a enter y ves aparecer el código. Funciona. Es rápido. Parece magia.
Esto es el vibe coding — y genuinamente es fantástico, hasta cierto punto.
El problema es que ese "hasta cierto punto" está más cerca de lo que la mayoría cree.
Qué es el Vibe Coding
El vibe coding es la práctica de dirigir agentes AI a través del lenguaje natural en lugar de especificaciones precisas. Describes el rollo de lo que quieres — la forma general, el comportamiento, la sensación — y dejas que el agente resuelva los detalles.
En su mejor momento, suena así:
"Añade una barra de búsqueda a la lista de productos que filtre por nombre y categoría en tiempo real"
Y el agente produce algo que funciona a la primera.
El término se ha popularizado porque captura algo real: los buenos agentes AI son ahora tan capaces que muchas veces no necesitas ser hiperpreciso. Puedes describir resultados en lugar de implementaciones y obtener resultados excelentes.
Dónde el Vibe Coding Brilla de Verdad
Seamos honestos sobre los casos donde genuinamente funciona:
Tareas pequeñas y autocontenidas. "Escribe una función que convierte un color hex a RGB." No hace falta contexto, entrada y salida claras, bajo impacto si sale mal.
Scripts para una sola vez. Necesitas renombrar 500 archivos según un patrón, parsear un archivo de log JSON o generar un CSV desde una consulta a base de datos. Una conversación, hecho.
Prototipado exploratorio. Todavía no sabes qué quieres. Estás usando la AI para pensar en voz alta, probando distintos enfoques para ver qué encaja.
Retoques de UI sin riesgo. "Mueve el botón a la derecha y ponlo azul." El cambio es visible, reversible y acotado.
En estos casos, el vibe coding no solo es aceptable — es la herramienta correcta. Añadir más estructura te frenaría sin mejorar el resultado.
Dónde Se Rompe
Aquí es donde se pone incómodo.
Cuando el codebase crece. Un agente AI tiene una ventana de contexto. Incluso con ventanas grandes, los agentes no pueden tener todo tu codebase en mente. Empiezan a tomar decisiones localmente razonables que contradicen decisiones tomadas hace tres sesiones.
Cuando terminan las sesiones. Cada nueva conversación empieza desde cero. El agente que pasó dos horas ayudándote a diseñar tu sistema de autenticación ayer no recuerda nada de eso hoy. Cuando describes el problema de nuevo, lo describes de forma ligeramente diferente, y el agente toma un enfoque ligeramente diferente.
Cuando varios agentes trabajan en paralelo. Ejecutas el Agente A en el frontend y el Agente B en el backend. Ninguno sabe qué decidió el otro. Ahora tienes interfaces incompatibles, lógica duplicada y convenciones de nombres inconsistentes.
Cuando el alcance se expande. Empezaste con "añadir una barra de búsqueda". Ahora necesita soportar filtros, paginación y búsquedas guardadas, y tiene que funcionar con la API que construiste el mes pasado. El agente no conoce la forma de esa API. Lo adivina, y lo adivina mal.
Cuando los requisitos cambian. El product manager decide que los filtros deben funcionar de otra manera. Se lo dices al agente. Cambia el frontend. No sabe que la lógica del backend también necesita cambiar. Shipper una feature rota.
Estos no son casos extremos. Si estás construyendo algo más allá de prototipos simples, vas a encontrarte con todos ellos.
La Pieza que Falta
Lo que le falta al vibe coding es una fuente de verdad.
Cuando un desarrollador humano se une a un equipo, no empieza a programar inmediatamente. Lee los docs de arquitectura, revisa los contratos de API, entiende qué ya se ha decidido. Tiene un contexto compartido con el resto del equipo.
Los agentes AI no tienen eso por defecto. Cada sesión, empiezan desde cero. Inventan contexto arquitectónico sobre la marcha, basándose en lo que está en la conversación y en el código que pueden ver.
Las specs llenan este hueco. Una spec es una descripción persistente y estructurada de qué debe construirse — los criterios de aceptación, las restricciones, las decisiones ya tomadas. Cuando un agente lee una spec antes de empezar a trabajar, tiene contexto. Cuando termina, puedes comparar su output con la spec para ver si hizo lo que se pedía.
Esto no es microgestionar agentes AI. Es darles el mismo contexto de partida que tendría un desarrollador humano.
Cómo Hacer Vibe Coding Responsable
El objetivo no es abandonar el vibe coding — es añadir la estructura justa donde importa.
Escribe specs para cualquier cosa que abarque varias sesiones. Si una feature tardará más de una conversación en construirse, escribe una spec breve primero. No necesita ser un documento formal — solo criterios de aceptación y restricciones clave. Esto se convierte en el contexto que compartes con el agente al inicio de cada sesión.
Usa criterios de aceptación, no instrucciones de implementación. En lugar de decirle al agente exactamente cómo construir algo, describe qué aspecto tiene "hecho". "Los usuarios pueden filtrar por categoría y la URL se actualiza para reflejar el filtro activo" es mejor que un plan detallado de implementación. Los agentes son buenos tomando decisiones de implementación; necesitan ayuda para saber cómo se ve el comportamiento correcto.
Registra lo que se ha decidido. Mantén un registro ligero de las decisiones arquitectónicas — qué patrón de diseño estás usando, cómo es el modelo de datos, cómo funciona el manejo de errores. Cuando empieza una nueva sesión, comparte las decisiones relevantes. Esto evita que el agente reinvente ruedas que ya has construido.
Comprueba el output contra las specs. Después de que el agente entregue código, verifica contra tus criterios de aceptación. No con una revisión de código — eso es trabajo del agente — sino una comprobación de comportamiento. ¿Hace realmente lo que dijiste que debía hacer?
Usando Planu para esto
Planu es un servidor MCP que automatiza la mayor parte de esto. Almacena specs en un formato estructurado, las comparte con tu agente AI automáticamente y ejecuta detección de drift para detectar casos en que la implementación se desvió de la spec. Escribes los criterios de aceptación una vez; Planu se asegura de que cada sesión tenga acceso a ellos.
El Equilibrio
El vibe coding y las specs no son opuestos. Son complementarios.
Usa vibe coding para el trabajo rápido, exploratorio y de bajo riesgo. Usa specs para features que importan, que abarcan varias sesiones, o en las que van a trabajar varios agentes simultáneamente.
El punto óptimo es saber en qué situación te encuentras. ¿Script pequeño? Vibe. ¿Nuevo flujo de pago? Escribe una spec primero.
Los desarrolladores que sacan más partido de los agentes AI no son los que tratan cada interacción como un vibe — ni los que escriben documentos de requisitos formales antes de tocar el teclado. Son los que han aprendido a reconocer qué modo pide cada tarea.
Próximos Pasos
- La Guía Completa de Spec Driven Development — la metodología completa
- Por Qué los Agentes AI Necesitan Specs — qué pasa sin ellas, en detalle
- Primeros Pasos con Planu — añade gestión de specs a tu flujo de trabajo en 5 minutos