Vibe Coding paso a paso
De la idea a una versión funcional de tu app, con ayuda de la inteligencia artificial que elijas y sin escribir código .
No hace falta entenderlo todo ahora. La guía te lleva paso a paso y tu avance se guarda automáticamente en este navegador: todo queda en tu dispositivo, nada se envía a ningún servidor. Empieza cuando quieras.
¿Prefieres empezar de cero?
¿Cambias de navegador o de dispositivo? La copia contiene tus respuestas: guárdala en un lugar privado.
No necesitas saber programar. Necesitas saber dirigir.
Hoja de ruta
¿Qué es el vibe coding?
El vibe coding es una forma de crear software en la que tú diriges el proyecto y la inteligencia artificial hace el trabajo técnico. No se trata de pedir «hazme una app completa» y esperar un milagro, sino de preparar bien la idea, dividir el trabajo en fases y dar instrucciones claras.
En esta guía usarás dos tipos de ayuda:
Tu asesor: un chat de IA, como ChatGPT o Claude, que te ayuda a pensar, ordenar y preparar documentos.
Tu agente programador: una herramienta como Codex, Claude Code o similar, que trabaja sobre el código de la app.
La clave es sencilla: tú tomas las decisiones; la IA te ayuda a ejecutarlas.
¿Qué puedes esperar de esta guía?
No construye tu app directamente. Te ayuda a preparar el camino para construirla mejor, con un chat de IA que actúa como asesor y con un agente programador que trabaja sobre el código.
¿Por qué no atarse a una herramienta?
Las herramientas de IA cambian rápido. Hoy puedes usar ChatGPT, Claude, Codex, Claude Code, Gemini u otra; mañana puede aparecer una mejor. Por eso esta guía no depende de una herramienta concreta.
Lo importante no es la marca de la IA, sino el método: idea clara, documentos bien preparados, fases pequeñas y control del proceso. Tus documentos son tuyos: si cambias de herramienta, no pierdes el proyecto.
Otros conceptos que acabarán sonándote (consúltalos cuando los necesites)
Antes de empezar
Crea la base de tu proyecto
Aquí vas a crear una base ordenada para guardar todo lo importante de tu MVP. No tienes que rellenar nada todavía: solo dejar lista la estructura desde la que vas a trabajar.
Descarga la estructura base
Tendrás en tu dispositivo los archivos principales, listos para usar. Aquí vivirá tu proyecto mientras lo preparas y hasta que decidas si quieres publicarlo.
Opcional: guardar versiones con Git
Git sirve para guardar versiones de tu proyecto, como puntos de control a los que puedes volver si algo sale mal. Es útil, pero no obligatorio: si ahora te suena raro, puedes saltarte este bloque sin problema.
Si te animas a activarlo, sigue estas instrucciones.
Importante: haz esto dentro de la carpeta descomprimida del proyecto, no dentro del archivo ZIP.
PC Windows: abrir la terminal en la carpeta correcta
1. Descomprime el ZIP de tu proyecto.
2. Abre la carpeta descomprimida. Si ves AGENTS.md, HANDOFF.md, .gitignore y Documentos, estás en el sitio correcto.
3. Haz clic en la barra de dirección de la carpeta, arriba del todo.
4. Escribe cmd y pulsa Enter. Se abrirá una terminal ya colocada en esa carpeta.
Otra opción: clic derecho en un espacio vacío de la carpeta y elige Abrir en Terminal.
Comprobar si tienes Git
Copia esto, pégalo en la terminal y pulsa Enter:
git --version
Si aparece algo parecido a git version ..., ya lo tienes.
Si Windows dice que no reconoce el comando, instala Git desde la página oficial: git-scm.com/downloads/win. Después cierra la terminal, abre una nueva y vuelve a probar git --version.
Mac: abrir la terminal en la carpeta correcta
1. Descomprime el ZIP de tu proyecto.
2. Abre la carpeta descomprimida en Finder. Si ves AGENTS.md, HANDOFF.md, .gitignore y Documentos, estás en el sitio correcto.
3. Abre la app Terminal.
4. Escribe cd dejando un espacio al final.
5. Arrastra la carpeta del proyecto desde Finder hasta la terminal y pulsa Enter. Así no tienes que escribir la ruta a mano.
Comprobar si tienes Git
Copia esto, pégalo en la terminal y pulsa Enter:
git --version
Si aparece algo parecido a git version ..., ya lo tienes.
Si macOS te ofrece instalar herramientas de desarrollo, acepta la instalación y vuelve a probar.
También puedes instalar Git desde la página oficial: git-scm.com/downloads/mac. Si ya usas Homebrew, otra opción es copiar brew install git.
Primer guardado de versión
Cuando la terminal esté abierta en la carpeta correcta y Git funcione, copia este bloque entero, pégalo en la terminal y pulsa Enter:
git init git add . git commit -m "estructura inicial del proyecto"
Si Git te pide nombre y email, copia este bloque cambiando los datos por los tuyos:
git config --global user.name "Tu nombre" git config --global user.email "tu@email.com"
Después vuelve a copiar y pegar el bloque de Primer guardado de versión.
Lleva el control de lo que ya has hecho
En tu chat de IA
Tu asesor
Antes de construir, usa un chat de IA (ChatGPT, Claude, Gemini…) como asesor para pensar mejor tu MVP, ordenar tus ideas y preparar documentos claros. No es el : solo te ayuda a aclarar la idea, no toca el código. El asesor no manda. Tú diriges.
Asesor
Piensa contigo
- Aclara y ordena la idea
- Te ayuda a recortar
- Redacta los documentos
Aquí tienes textos listos para copiar y pegar en tu asesor.
Para investigar mercado y competencia
Úsala antes de cerrar del todo la idea, para detectar alternativas, huecos y dudas sin convertir esto en un curso de negocio.
Para que recorte funciones
Úsala cuando creas que estás metiendo demasiadas funciones en el MVP.
Para que te lo explique sencillo
Úsala cuando el asesor se ponga técnico y no entiendas lo que te dice.
Cuando sospechas que se lo inventa
Úsala si crees que el asesor está dando por hecho cosas que tú no le has dicho.
Para que no te dé la razón (abogado del diablo)
Los chats de IA tienden a validar lo que les cuentas. Úsala antes de dar el briefing por cerrado: mejor una pregunta incómoda ahora que semanas de trabajo después.
Lleva el control de lo que ya has hecho
En tu chat de IA
Tu idea
Pon en claro qué quieres hacer, para quién y por qué. No hace falta saber de tecnología: solo explicar tu idea con tus palabras.
1. Respondes unas preguntas aquí, en la página, y las guardas.
2. Le pasas esas respuestas a tu asesor y él las convierte en tu primer documento (el briefing).
Paso 1 de 2 · aquí en la página
Responde a unas preguntas sobre tu idea
Las preguntas están repartidas en 7 bloques. Ocho llevan la etiqueta Esencial: con esas respondidas ya puedes pasar al siguiente paso. El resto afinan tu briefing: respóndelas si puedes y deja en blanco lo que aún no tengas claro.
¿No sabes qué responder en alguna pregunta? A su lado verás un botón Ayúdame…. No responde por ti: prepara una pregunta para que tu asesor te ayude a pensarla. Así se usa:
Pulsa «Ayúdame…»: se copia una pregunta lista para tu chat de IA.
Pégala en tu chat (tu asesor) y responde lo que te vaya preguntando.
Copia la respuesta final y pégala en el campo de aquí.
La idea 0/3
Qué quieres hacer.
Ponle un nombre de trabajo. No tiene que ser definitivo.
Explícalo en una o dos frases, como se lo contarías a alguien conocido.
Esta frase será la brújula del proyecto.
El mercado 0/3
Qué alternativas existen, en qué te diferencias y si estás entrando en un nicho pequeño o grande.
Directos: hacen algo parecido. Indirectos: resuelven el problema de otra forma.
Busca una diferencia concreta y creíble, no una promesa enorme.
No hace falta calcularlo perfecto. Basta con una primera hipótesis razonable.
Las personas 0/3
Para quién existe la app, qué problema tiene y cómo lo resuelve hoy.
Piensa en personas concretas, no en «todo el mundo».
Describe qué pasa ahora y por qué resulta incómodo.
Piensa en herramientas, costumbres, hojas de cálculo, WhatsApp, llamadas, papel o soluciones manuales.
Lo mínimo 0/3
Qué debe tener la primera versión y qué queda fuera.
Solo lo mínimo para que la app tenga sentido.
Esto evita que la IA complique demasiado el proyecto.
Describe el resultado final de forma sencilla.
El enfoque 0/2
Por qué merece la pena y cómo no perder el rumbo.
No hace falta una gran justificación. Basta con explicar qué mejora aporta.
Pensarlo ahora ayuda a construir con más cabeza.
Modelo de negocio 0/2
Cómo podría sostenerse el producto, aunque no se monetice desde el primer día.
Puede ser ahora, más adelante o una hipótesis. No fuerces ingresos si todavía no toca.
Anota el modelo probable: vender a empresas, a consumidores, a instituciones, marketplace, servicio, etc.
Objetivos 0/3
Qué vas a mirar después de lanzar el MVP para decidir si merece la pena seguir.
Elige una señal concreta: uso, registros, publicaciones, reservas, contactos, repetición, etc.
Pueden ser herramientas simples: analítica web, formularios, entrevistas, hojas de cálculo o logs básicos.
No tiene que ser estadístico perfecto. Busca una muestra suficiente para aprender algo real.
Cuando termines, descarga tus respuestas
Tu avance ya se guarda solo en este navegador. Esto es distinto: descargas un archivo .txt con tus respuestas para pegárselo a tu asesor en el paso 2. No hace falta que esté perfecto: es solo el punto de partida.
Paso 2 de 2 · en tu chat con el asesor
Convierte tus respuestas en tu primer documento
Ahora tu asesor ordena todo por ti. Abre tu chat, dale las respuestas que acabas de guardar y pégale el prompt de abajo: te devolverá tu , el primer documento del proyecto y tu idea ya ordenada con sus hipótesis y riesgos.
Lleva el control de lo que ya has hecho
Con tu asesor · mismo hilo
Tu producto
Sigue en la misma conversación con tu asesor. Estos dos documentos definen cómo es tu producto: su estructura funcional y su diseño, partiendo del usuario real, el problema, el benchmark, la propuesta de valor, el modelo de negocio, los objetivos de medición, los límites del MVP y los riesgos detectados. Pega cada prompt en orden y guarda la respuesta.
Lleva el control de lo que ya has hecho
Con tu asesor · mismo hilo
Tu plan
Ya tienes diagnosticada la idea, el mercado, el modelo y los objetivos. Ahora vas a preparar el plan de trabajo para construir solo el MVP mínimo.
Crearás tres cosas: las instrucciones de arranque, el plan por fases y las reglas que tu agente deberá seguir siempre, incluida una regla clave: no construir funcionalidades futuras, monetización avanzada ni analítica compleja salvo autorización explícita.
Primero: elige el stack con tu asesor
La decisión que más condiciona el coste, la publicación y el mantenimiento de tu MVP es el stack (el conjunto de tecnologías). No dejes que el agente la tome por omisión: pídesela a tu asesor y anótala, porque la usarás al crear AGENTS.md.
Antes de construir (opcional pero recomendado): valida con personas reales
El paso más barato de todo el método: cuenta la idea a 3–5 personas del perfil de tu usuario antes de escribir una línea de código. Si nadie reconoce el problema, vuelve al briefing — te acabas de ahorrar semanas.
Este prompt le pide a tu asesor que te prepare la mini-entrevista:
04-prompt-maestro.md, 05-plan-por-fases.md y AGENTS.md). Cuando ya tengas los documentos numerados (01–05) y el AGENTS.md, ve a «Tu agente».Lleva el control de lo que ya has hecho
Con tu agente programador
Tu agente
El agente programador (Codex, Claude Code, Antigravity…) trabaja dentro de la carpeta de tu proyecto y escribe el código. No tienes que programar: tu trabajo es aprobar los pasos, probar el resultado y preguntar cuando algo no esté claro. El asesor sigue siendo tu espacio para pensar y comprobar decisiones. El agente construye. Tú diriges.
Agente
Construye la app
- Lee el contexto
- Propone antes de cambiar
- Construye y explica
Cómo trabajar con tu agente
-
Selecciona la carpeta de tu proyecto
En la herramienta del agente, abre la carpeta que descargaste y descomprimiste en «Archivo». Trabajarás siempre ahí: contiene
AGENTS.md,HANDOFF.md,.gitignoreyDocumentos. -
Abre el primer hilo y dale el contexto
Pídele que lea
AGENTS.mdy los documentos 01–05 deDocumentos, especialmente el prompt maestro y el plan por fases. Primero debe proponerte la primera fase; todavía no debe tocar código. Tienes esta primera instrucción lista para copiar más abajo, en «Abrir el primer hilo». -
Contrasta la propuesta con tu asesor
Si algo no te cuadra, copia la respuesta del agente en tu asesor. Pídele que te diga, en lenguaje sencillo, qué entiende, qué falta y qué riesgos ve. Vuelve al agente con las decisiones claras.
-
Aprueba una fase pequeña y constrúyela
Cuando el plan tenga sentido, confirma una sola fase. El agente construye, te explica los cambios y te dice cómo comprobarlos. No mezcles varias fases ni aceptes cambios grandes sin entenderlos.
-
Comprueba el resultado y pide una segunda opinión
Prueba lo que te indique el agente. Comparte con el asesor el resumen o las dudas que queden para comprobar que vais en la dirección correcta y decidir el siguiente ajuste.
-
Cierra la fase y abre el siguiente hilo
Antes de continuar, pide al agente que actualice
HANDOFF.md. En el hilo nuevo, que leaAGENTS.mdyHANDOFF.md, confirme el siguiente paso y vuelva a proponértelo.
La primera vez empiezas con los documentos. Después, en cada fase se repite el mismo ciclo: construyes, lo compruebas con tu asesor si lo necesitas, cierras la fase actualizando HANDOFF.md y abres un hilo nuevo para la siguiente. Cuando terminas todas las fases, pasas a «Revisión».
HANDOFF.md actualizado y explícale el problema desde cero. Una cosa más: si el agente te pide una clave API, va siempre en un archivo .env que nunca se comparte ni se sube a internet — pídele que lo configure así.Plantillas listas para copiar
Plantilla · Abrir el primer hilo (empezar el proyecto)
Plantilla · Abrir un hilo nuevo (retomar el trabajo)
Plantilla · Pedir una segunda opinión al asesor
Plantilla · Cerrar una fase y actualizar el handoff
Lleva el control de lo que ya has hecho
Cuando tienes una primera versión
Revisión
Cuando tengas una versión que funciona, toca revisarla con calma en tu ordenador, detectar riesgos y decidir cómo prepararla antes de compartirla. No todos los proyectos se publican igual: una web informativa, una app con usuarios, una tienda o una herramienta interna tienen necesidades distintas.
El agente te ayudará a clasificar el proyecto, recomendar una ruta de publicación y pedirte confirmación antes de crear repositorios, subir código o publicar en internet. Pide también una segunda opinión a un chat de IA externo (distinto del que construye): detecta cosas que el propio agente no ve. Tienes el prompt más abajo, en los rescates.
Comprobación de negocio ligera
Antes de ampliar, haz estas preguntas sencillas:
¿El MVP sigue resolviendo el problema inicial?
¿Se ha construido solo lo imprescindible?
¿La propuesta de valor se entiende frente a las alternativas?
¿La métrica de éxito se puede medir con herramientas simples?
¿Qué habría que validar con usuarios reales antes de seguir ampliando?
Antes de preparar la publicación
Qué tipo de proyecto tienes delante
Antes de elegir dónde publicar, pídele al agente que clasifique el proyecto: web informativa, app con usuarios, tienda, comunidad, herramienta interna, app con IA, app con pagos u otro caso.
La ruta cambia según si será público o privado, si maneja datos personales, si tiene pagos, si recibe contenido de usuarios, si necesita base de datos o si debe usar dominio propio.
Seguridad y datos
No compartas tus claves API (las contraseñas que dan acceso a los servicios de IA y otros): si una se filtra, cualquiera puede gastar en tu nombre.
Los datos de tus clientes son tu responsabilidad: guarda solo lo necesario y protégelos. Hay leyes (como el RGPD en Europa) que obligan a cuidar los datos personales.
Si hay pagos, datos sensibles, cuentas de usuario o contenido publicado por otras personas, no publiques una versión real sin revisar antes privacidad, permisos, moderación y seguridad básica.
Costes a tener en cuenta
Construir el MVP puede ser gratis, pero mantenerlo en línea no siempre.
Ten en el radar el hosting (el alojamiento donde vive la app en internet), la base de datos, el dominio y, si tu app usa IA, el coste por uso de esa IA. Mejor saberlo antes de publicar.
Vista previa no es lo mismo que producción
Una vista previa sirve para probar y enseñar una versión controlada. Producción es la versión pública o real que pueden usar personas externas.
El agente debe separar esos dos pasos y pedirte permiso explícito antes de publicar en producción o crear un repositorio público.
Si algo se atasca · rescates
Prompts para desatascar al agente cuando se complica, entra en bucle o se pone demasiado técnico. Cópialos y pégaselos en el chat del agente. El rescate 3 es la excepción: va dirigido a un chat externo que no ve tu carpeta, así que acompáñalo de tu HANDOFF.md y del resumen de la última fase.
Lleva el control de lo que ya has hecho
Has recorrido el camino
¡Enhorabuena!
Has pasado de una idea a una forma clara y ordenada de construir tu MVP.
Ya tienes un método, una estructura de documentos, un plan por fases y reglas para trabajar con tu agente. No hace falta hacerlo todo perfecto: lo importante es que ahora sabes qué paso dar y por qué.