Vibe coding para principiantes: guía práctica

Qué es el vibe coding

El término se popularizó para describir una forma de programar en la que tú explicas lo que quieres y la IA escribe el código. En lugar de teclear instrucciones, conversas: pides una función, miras el resultado, pides un cambio.

Es una forma real de trabajar con herramientas como Cursor, Claude Code, Lovable, Bolt o Replit, pero no es un atajo para dejar de entender lo que se construye. Cuanto mejor sepas explicar lo que necesitas y comprobar el resultado, mejores serán los proyectos.

Qué necesitas para empezar

• Una idea pequeña y concreta: una calculadora, un formulario de contacto, un listado con filtros.
• Una herramienta de IA para programar. Hay editores con IA integrada y generadores de aplicaciones en el navegador; comprueba qué incluye cada una, sus límites, precios y condiciones actuales.
• Paciencia para probar y corregir: la primera versión casi nunca es la buena.
• Un sistema de versiones (por ejemplo Git o el historial de la propia herramienta) para poder volver atrás.

No necesitas saber programar para empezar, pero sí aprender poco a poco a leer lo que aparece: nombres de archivos, mensajes de error, qué hace cada parte. Eso es lo que te permite dirigir a la IA con criterio.

El flujo de trabajo en cuatro pasos

• Describe una sola función con su resultado esperado, no la app entera.
• Pide a la IA que la implemente y que te explique qué ha hecho en lenguaje sencillo.
• Prueba: usa la función con datos normales y con datos que deberían dar error.
• Si falla, copia el mensaje de error completo, di qué esperabas y qué pasó, y pide el arreglo. Luego guarda una versión.

Repite el ciclo. Cada vuelta añade una pieza pequeña y verificada, en vez de una montaña de código que nadie ha comprobado.

Un prompt para pedir una función nueva

Este esquema sirve en un editor con IA o en un chat. Lo importante es dar contexto, límites y una forma de comprobar el resultado:

Estoy construyendo [descripción breve del proyecto] con [tecnología, si la sabes].

Quiero añadir esta función: [qué debe hacer, en una o dos frases].

Cómo sabré que funciona: [ejemplo de entrada y resultado esperado].

Reglas:
- Cambia solo lo necesario para esta función.
- No borres ni reescribas código que no esté relacionado.
- No incluyas contraseñas, claves ni datos personales en el código.
- Al terminar, explícame en lenguaje sencillo qué archivos has tocado y cómo probarlo.

Si te falta información, pregúntamela antes de escribir código.

Qué hacer cuando algo falla

Los errores forman parte del proceso. Lo que marca la diferencia es cómo los describes: «no funciona» obliga a la IA a adivinar; un mensaje de error y el comportamiento esperado le dan algo concreto con lo que trabajar.

Al ejecutar [la acción que haces] me aparece este error:

[pega aquí el mensaje de error completo]

Esperaba que [lo que debería pasar] y en cambio [lo que pasa].

Explícame primero cuál crees que es la causa y después propón el arreglo más pequeño posible. No cambies partes del proyecto que no estén relacionadas con el error.

Si después de dos o tres intentos la IA da vueltas sin resolverlo, para y pídele que resuma el problema y qué ha probado ya. A veces conviene volver a una versión guardada y plantearlo de otra manera.

Errores habituales de quien empieza

• Pedir demasiado de golpe y no saber cuál de los cambios rompió algo.
• Aceptar todos los cambios sin leer el resumen de lo que ha tocado la IA.
• No guardar versiones y perder una versión que funcionaba.
• Pegar claves de API, contraseñas o datos personales en el chat o en el código.
• Publicar sin probar con datos incorrectos, en móvil y con una persona ajena al proyecto.
• Dar por buena la seguridad porque la app «funciona».

Si el proyecto va a tener usuarios reales o guardar datos personales, repasa antes la normativa de protección de datos en las fuentes oficiales y, si es delicado, pide la revisión de una persona con experiencia.

Plantillas para no empezar de cero

En PromptNow, la plantilla para pedir una función en Cursor o Claude Code recoge en un formulario el proyecto, la función y los límites, y genera un prompt listo para pegar. La de arreglar errores hace lo mismo con el mensaje de error y el comportamiento esperado.

Si todavía estás en la fase de idea, la plantilla de prompt maestro para Lovable o Bolt te ayuda a describir la app completa de una vez. En todos los casos son punto de partida: tú revisas y pruebas lo que la IA produce.