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.

No hace falta entenderlo todo de golpe. El secreto es seguir paso a paso y aprender practicando.

¿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.

¿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í.

Otras palabras que acabarán sonándote

Prompt. La instrucción de texto que le das a la IA.

Agente constructor. La IA que escribe el código de tu app (Claude Code, Codex, Antigravity…).

handoff.md. El archivo con el estado del proyecto para retomarlo en otro hilo. La memoria entre conversaciones.

agents.md / claude.md. El archivo con las reglas permanentes que el agente lee solo.

En local. Probar la app en tu propio ordenador, antes de que la vea nadie.

Desplegar (deploy). Publicar la app en internet para que otros la usen.

Repositorio. El sitio donde se guarda y se versiona el código del proyecto.

Commit y push. Guardar los cambios (commit) y subirlos al repositorio (push).

Stack. El conjunto de tecnologías con las que se construye la app.

¿Por qué no atarse a una herramienta?

Lo bueno de la arquitectura agnóstica en IA es que no te ata a ningún modelo. Las herramientas cambian rápido, pero el método te sirve igual.

Usa el chat de IA y el agente constructor que prefieras (ChatGPT, Claude, Codex…) gratuitos o de pago. Ahora y en el futuro.

Y como la memoria de tu proyecto vive en archivos tuyos y no dentro de una herramienta, puedes cambiar de agente sin perder nada.

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.

Seguridad y datos

No compartas tus claves (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.

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.

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 documento de contexto que el agente necesita para arrancar y, más adelante, para retomar el trabajo en cada hilo nuevo. El chat corriente 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 pauta al completarla.

La regla de oro: el agente constructor no recuerda los hilos anteriores. Por eso cada hilo nuevo empieza diciéndole qué documento leer: el primero, tu prompt maestro (04); los siguientes, el handoff.md actualizado. Lo que no quede escrito en un documento, se pierde.
  1. Crea la carpeta del proyectoUn sitio único en tu ordenador para todo el MVP.
    Consejos

    Ponle un nombre corto, en minúsculas y sin espacios ni acentos (por ejemplo mi-mvp): te evitará problemas más adelante.

    Guárdala en un sitio fácil de encontrar, como Escritorio o Documentos, no dentro de una carpeta temporal de descargas.

  2. Dentro, crea una subcarpeta /docsAhí van los documentos de referencia (01–08). El AGENTS.md y el handoff.md irán en la raíz, no en /docs.
    Consejos

    /docs es solo para los documentos. El código de la app lo creará el agente en otras carpetas; no lo toques tú.

    Los dos archivos de la raíz son los "vivos": AGENTS.md (las reglas) y handoff.md (el estado). El AGENTS.md lo colocas tú ahora (pauta 4); el handoff.md lo creará el agente al cerrar la primera fase (pauta 7).

  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í al revisar y publicar.
    Consejos

    Respeta el número delante (01-, 02-…): así salen ordenados y puedes citarlos fácil ("lee el 04").

    Si un documento te quedó flojo, mejóralo en el chat antes de guardarlo: el agente construirá a partir de lo que pongas aquí.

  4. Guarda en la raíz el AGENTS.md (o CLAUDE.md)Es el contenido del documento 05, que ya generaste: guárdalo en la raíz con ese nombre, porque el agente lo lee por su cuenta en cada hilo.
    Consejos

    El nombre depende de la herramienta: CLAUDE.md para Claude Code, AGENTS.md para Codex y otros. Por dentro es el mismo contenido.

    Es el único documento que el agente lee solo, sin que se lo pidas; por eso va en la raíz. Mantenlo corto y con lo que de verdad importa.

    No te extrañe verlo en dos sitios: queda como 05-agents-md.md en /docs (tu copia de referencia, junto al resto de documentos) y como AGENTS.md en la raíz (la copia "viva" que el agente lee solo). Es el mismo contenido, y está duplicado a propósito.

    El handoff.md todavía no existe: aquí solo colocas el AGENTS.md. El agente creará el handoff.md más adelante, la primera vez que cierres una fase y le pidas guardar el estado (pauta 7).

  5. Ahora vamos con el agente constructor
  6. Abre el primer hilo y dile qué leerPídele que lea tu prompt maestro (documento 04) y los documentos de /docs, y que proponga un plan por fases antes de tocar código.
    Consejos

    El agente no sabe nada de tu proyecto hasta que se lo das: empieza siempre indicándole qué documento leer.

    No le dejes programar hasta que el plan te cuadre. Si algo no lo entiendes, pídele que te lo explique en lenguaje sencillo.

  7. Trabaja una fase por hiloCada fase, una conversación nueva en el agente constructor. No mezcles fases y confirma antes de cambios grandes.
    Consejos

    Una fase = una conversación. Al terminar una fase, abre un hilo nuevo para la siguiente: el agente rinde mejor con el contexto limpio.

    Si una fase se hace muy larga, divídela. Mejor cinco fases pequeñas y revisables que una grande imposible de seguir.

  8. Al cerrar cada fase, actualiza el handoffPídele que resuma la fase y vuelque el estado en handoff.md (en la raíz): la primera vez lo crea y, en las siguientes, solo lo actualiza. Es la memoria del proyecto entre hilos. Tienes la plantilla abajo.
    Consejos

    El handoff.md es lo que permite retomar el trabajo en otro hilo sin empezar de cero. Si no lo actualizas, lo pierdes.

    Échale un vistazo a lo que escribe: que refleje de verdad dónde estáis. Es tu red de seguridad, merece treinta segundos.

  9. Para seguir en otro hilo, que lea el handoffCuando el contexto se llene o empieces fase nueva, abre un hilo y pídele que lea AGENTS.md y handoff.md. Cuando confirme que lo ha entendido, seguís como en cualquier fase: te propone el siguiente paso (el que marca el handoff), lo apruebas y construye. No hace falta pegar nada largo.
    Consejos

    Esto solo funciona si mantienes el handoff al día (pauta 7). Con eso, retomar es tan simple como "lee el handoff y sigue".

    Abre hilo nuevo en cuanto notes que el agente se despista o repite errores: suele ser señal de que el contexto está saturado.

  10. Usa un chat de IA externo como auditorAntes de cambios grandes o de publicar, pide una segunda opinión a un chat distinto del que construye.
    Consejos

    Un par de ojos distintos detecta cosas que el propio agente no ve, porque no está "enamorado" de su propio código.

    Tienes el prompt rápido en «Ayudas» (segunda opinión) y la auditoría completa en «Revisa y publica» (documento 07).

  11. Revisa, prueba y solo entonces publicaVerlo en local (en tu ordenador) → confirmar → commit y push (guardar y subir los cambios a GitHub) → desplegar. Los prompts de auditoría y despliegue los tienes en «Revisa y publica».
    Consejos

    "En local" es probarlo en tu ordenador antes de que lo vea nadie. No publiques sin haberlo abierto tú primero.

    Publica al final de una fase estable, nunca a mitad de un cambio. Si algo falla en producción, podrás volver a la última versión que funcionaba.

El ciclo, en corto: las pautas 6, 7 y 8 se repiten en bucle hasta que la app esté terminada. En cada vuelta: construyes una fase (6), la cierras pidiéndole que actualice el handoff.md (7) y, cuando el hilo se llena o empiezas otra fase, abres uno nuevo y le pides que lea el handoff para seguir (8). Cada hilo nuevo retoma justo donde lo dejó el anterior. La pauta 5 es solo la primera vez; después, los hilos nuevos se abren como en la pauta 8. Cuando ya no quedan fases, pasas a auditar y publicar (9 y 10).
6 Construir una fase 7 Cerrar la fase y actualizar el handoff 8 Abrir hilo nuevo y leer el handoff se repite Al acabar las fases → auditar y publicar (9 y 10)
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, pídele que lea el handoff.md actualizado y explícale el problema desde cero.

Plantillas listas para copiar

Plantilla · Abrir un hilo nuevo (retomar el trabajo) 
Retomamos un proyecto en marcha. Soy emprendedor/a sin perfil técnico.

Antes de nada, lee estos archivos del proyecto y dime que los has entendido:
- AGENTS.md (en la raíz): tus instrucciones permanentes.
- handoff.md (en la raíz): el estado actual y dónde lo dejamos.
- En /docs tienes los documentos de referencia (01–08); consulta los que necesites.

Cuando los tengas claros, continúa desde el «siguiente paso» que marca el handoff. Antes de cambios grandes, explícame el plan y espera mi confirmación.
Plantilla · Cerrar una fase y actualizar el handoff 
Cerramos la fase actual. Hazlo en dos partes.

1) Resúmeme la fase:
- Qué se construyó.
- Qué archivos se crearon o modificaron.
- Cómo pruebo que funciona (pasos sencillos).
- Qué queda pendiente.
- Riesgos o dudas detectadas.

2) Crea o actualiza el archivo handoff.md en la raíz del proyecto con el estado actual, de forma que otro hilo pueda retomar el trabajo solo leyéndolo. Incluye: qué es el proyecto, qué ya funciona, qué documentos consultar, dónde lo dejamos y el siguiente paso concreto.

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 preparando el camino

Primero se construye en pequeño, pero no de cualquier manera.
Dejando las puertas abiertas 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.