Vibe Coding paso a paso Creado por Raquel Marco
Paso 1 de 8Inicio
Guía práctica

Vibe Coding paso a paso

Convierte una idea de negocio en la primera versión funcional de tu app, con ayuda de la inteligencia artificial y sin escribir código.

Una guía práctica para emprendedores que quieren preparar correctamente su MVP (la primera versión mínima) antes de construirlo con agentes de IA como Codex, Claude Code o Antigravity.

¿Qué es el vibe coding?

El vibe coding es una forma de crear software trabajando con una IA como compañera de desarrollo. Tú defines la idea, marcas el objetivo, revisas el resultado y tomas las decisiones. La IA ayuda a escribir código, proponer estructuras y avanzar más rápido. La clave no es pedirle «hazme una app completa», sino guiar el proceso por fases con contexto claro y buenos documentos. Esas instrucciones de texto que le das a la IA se llaman prompts.

¿Qué es un MVP?

MVP significa Producto Mínimo Viable: la versión más sencilla de tu app que ya resuelve el problema principal y se puede usar de verdad. No es la app completa con todo, sino lo mínimo imprescindible para lanzarla, probarla con usuarios reales y mejorarla desde ahí.

Costes a tener en cuenta

Construir el MVP puede ser gratis, pero mantenerlo en línea no siempre: hosting (el alojamiento donde vive la app en internet), base de datos, dominio y, si tu app usa IA, el coste por uso de esa IA. Tenlo en el radar antes de publicar.

Importante: este documento no construye tu app. Te ayuda a preparar la documentación necesaria para construirla mejor, primero con un chat de IA corriente (como ChatGPT) y después con un agente de IA que construye la app (como Codex).

Inicio del flujo

Checklist inicial del MVP

Si te atascas en un apartado, pulsa «Prompt de ayuda», pégalo en tu chat de IA y deja que te ayude a concretar la idea.

Campos completados0 / 10

Un nombre de trabajo, aunque luego cambie.

Explica en pocas frases qué es y qué hace.

Qué dolor o necesidad concreta soluciona.

Quién lo usará y en qué contexto.

Lo mínimo que debe hacer para ser útil.

Qué información almacena la app.

Quién entra, cómo y qué puede ver o hacer.

Las secciones principales de la experiencia.

Dónde aporta valor real la IA (empieza por una función).

Qué quieres tener al terminar el MVP.

Cuando termines

Guarda tus respuestas y llévalas al chat de IA donde irás pidiendo los documentos para construir tu app.

Ver contenido. Puedes editarlo.
Siguiente paso: abre tu chat de IA favorito (ChatGPT, Claude u otro), empieza un hilo nuevo y sube ahí el documento que has guardado. Ese será el contexto base del proyecto. Después ve a «Prepara tu idea» y sigue pegando los prompts en ese mismo hilo.
A

Grupo A · en tu chat de IA

Prepara tu idea

Sube a tu chat de IA favorito el documento que has guardado con el contenido de la checklist. Luego usa estos prompts en orden, uno tras otro en el mismo hilo.

B

Grupo B · sigue en el mismo hilo

Prepara el handoff al agente

Genera los textos y las reglas que entregarás al agente que construirá la app (Claude Code, Codex, Antigravity…). A esa entrega se le llama handoff: el paquete de contexto que el agente necesita para arrancar. El chat normal todavía no construye nada.

Del documento al agente constructor

Pautas de trabajo con el agente

Cuando ya tengas tus documentos .md (archivos de texto sencillos que te genera el chat), esto es lo que harás. Marca cada paso al completarlo.

  1. Crea una carpeta del proyectoUn sitio único en tu ordenador para todo el MVP.
  2. Crea dentro una subcarpeta /docsAquí van todos los documentos generados, salvo el AGENTS.md/CLAUDE.md, que irá en la raíz.
  3. Guarda en /docs los documentos que ya tienes (01–06)Con los nombres sugeridos. El 07 y el 08 los añadirás aquí más adelante, al revisar y publicar.
  4. Crea en la raíz el archivo AGENTS.md o CLAUDE.mdEs el contenido del documento 05 (lo generaste en el Grupo B): las instrucciones permanentes para el agente.
  5. Abre el primer hilo con el agente (usa tu prompt maestro, documento 04)Da contexto y pide un plan antes de tocar código.
  6. Trabaja por fasesUna fase cada vez. No mezcles. Confirma antes de cambios grandes.
  7. Cierra cada fase con un resumenQué se hizo, qué archivos, cómo probarlo, qué queda y qué riesgos hay.
  8. Abre un hilo nuevo cuando el contexto se llenePega el handoff para no perder el rumbo.
  9. Usa un chat de IA externo como auditorAntes de aceptar cambios grandes, pide una segunda opinión.
  10. Revisa, prueba y solo entonces publicaVerlo en local (en tu ordenador) → confirmar → commit y push (guardar los cambios y subirlos a GitHub) → desplegar. Los prompts de auditoría y despliegue los tienes listos en «Revisa y publica».
No avances si… el agente quiere construir varias fases a la vez, añade dependencias sin explicarlas, reescribe toda la app por un cambio pequeño o no te explica qué tocó. Pídele que pare y vuelva a la fase actual.
Cuando algo se rompe: si el agente entra en bucle (arregla una cosa y rompe otra), para. No le repitas «arréglalo» sin más: pídele que vuelva a la última versión que funcionaba y que cambie una sola cosa cada vez. Si aun así no sale, abre un hilo nuevo con el handoff y explícale el problema desde cero.

Plantillas listas para copiar

Plantilla · Handoff para abrir un hilo nuevo 
Retomamos un proyecto en marcha. Soy emprendedor/a sin perfil técnico.

QUÉ ES EL PROYECTO
[1-2 frases del MVP] · Stack: [...]

QUÉ YA ESTÁ HECHO Y FUNCIONA
[Lista breve de lo construido]

DOCUMENTOS A CONSULTAR
En /docs: [los que apliquen]

ESTADO ACTUAL
[Dónde lo dejamos]

SIGUIENTE PASO CONCRETO
[Qué quiero ahora]

Antes de cambios grandes, explica el plan y espera mi confirmación.
Plantilla · Resumen de cierre de fase 
Cierra la fase actual con un resumen para mí:
- Qué se construyó en esta fase.
- Qué archivos se crearon o modificaron.
- Cómo pruebo que funciona (pasos sencillos).
- Qué queda pendiente.
- Riesgos o dudas detectadas.

No empieces la siguiente fase hasta que yo lo confirme.

Caja de herramientas

Prompts de apoyo, rescate y auditoría

Para tener a mano en cualquier momento del proceso: rescates cuando algo se atasca y mensajes listos para tu chat de IA externo o para el agente constructor.

C

Grupo C · cuando la app ya funciona

Revisa y publica

La recta final: revisar la app a fondo antes de publicarla y desplegarla con cabeza. La auditoría puedes pasársela también a un chat de IA externo para una segunda opinión; el despliegue, al agente que construyó la app.

Ya tienes el método

Construye pequeño, con el camino preparado

Primero se construye pequeño, pero no de cualquier manera: dejando preparado el camino para crecer.

Este documento no construye tu app: te ha ayudado a prepararla para construirla mejor. Ahora tienes tu briefing, tus documentos y tus plantillas. Ese es el trabajo que marca la diferencia.

Para cualquier consulta
Escríbeme a través de raquelmarco.com/contacto. Estaré encantada de ayudarte con tu MVP.