Método Vibe Coding MVP
Convierte una idea de negocio en una primera versión funcional de una app usando inteligencia artificial, paso a paso y sin necesidad de saber programar.
Una guía práctica para emprendedores que quieren preparar correctamente su MVP antes de construirlo con agentes IA como Codex, Claude Code, Antigravity u otras herramientas similares.
¿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.
Inicio del flujo
Checklist inicial del MVP
Si te atascas en un apartado, pulsa "Prompt de ayuda" y pégalo en tu chat IA favorito y mantén una charla para ayudarte con tu idea.
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.
Por qué te elegirían a ti y no otra opción.
Lo mínimo que debe hacer para ser útil.
Buenas ideas que dejas para más adelante.
Qué información almacena la aplicación.
Quién entra, cómo y qué puede ver o hacer.
Las secciones principales de la experiencia.
Qué se ve sin iniciar sesión y debe salir en buscadores.
Tareas que la app podría hacer sola.
Dónde aporta valor real la IA (empieza por una función).
Cómo genera ingresos o valor.
Cómo sabrás si funciona y a quién se lo enseñarás.
Lo que dejas fuera a propósito para no complicarte.
Qué quieres tener al terminar el MVP.
Cuando termines
Guarda tus respuestas y llévalas al chat IA. Estas son las acciones clave:
Ver contenido copiado
Fase 1 · en tu chat IA normal
Definir la idea
Pega el contenido del checklist que has copiado en tu chat. Luego usa estos prompts en orden, uno tras otro.
Fase 2 · en tu chat IA normal
Estructurar el proyecto
Convierte la idea en estructura, tareas, diseño y stack. Sigue en el mismo hilo.
Fase 3 · preparas la entrega
Handoff al agente constructor
Ahora generas los textos que entregarás al agente que construirá la app (Codex, Claude Code, Antigravity…). El chat IA normal todavía no construye nada.
Fase 4 · calidad y continuidad
Probar, auditar y mantener el contexto
Los documentos que te aseguran que el MVP funciona, está listo para publicar y puedes seguir trabajando sin perder el hilo.
Del documento al agente constructor
Tutorial: preparar el trabajo con el agente IA
Cuando ya tengas tus documentos .md, esto es lo que harás. Marca cada paso al completarlo.
- Crea una carpeta del proyectoUn sitio único en tu ordenador para todo el MVP.
- Crea dentro una subcarpeta
/docsAquí irán todos los documentos generados. - Guarda los 12 documentos .md en
/docsDel 01 al 12, con los nombres sugeridos. - Crea un archivo
AGENTS.mdoCLAUDE.mdLas instrucciones permanentes para el agente. Plantilla más abajo. - Abre el primer hilo con el handoff inicialDa contexto y pide un plan antes de tocar código.
- Trabaja por fasesUna fase cada vez. No mezcles. Confirma antes de cambios grandes.
- Cierra cada fase con un resumenQué se hizo, qué archivos, cómo probarlo, qué falta.
- Abre un hilo nuevo cuando el contexto se llenePega el handoff de traspaso para no perder el rumbo.
- Usa un chat IA externo como auditorAntes de aceptar cambios grandes, pide una segunda opinión.
- Revisa, prueba y solo entonces publicaVerlo en local → confirmar → commit → push → desplegar.
Plantillas listas para copiar
Plantilla · AGENTS.md / CLAUDE.md
# Instrucciones del proyecto para el agente IA ## Objetivo del proyecto [Resumen del MVP en 2-3 frases] ## Perfil de quien dirige el proyecto Persona emprendedora sin conocimientos técnicos avanzados. Explica los cambios con claridad y evita jerga innecesaria. ## Stack elegido [Next.js / Supabase / Vercel / GitHub, o el que corresponda] ## Forma de trabajo - Trabaja por fases. No construyas funcionalidades fuera de la fase actual. - Antes de cambios grandes, explica el plan y espera mi confirmación. - Después de cada cambio, resume los archivos modificados e indica cómo probar el resultado. - No introduzcas dependencias nuevas sin justificarlo. - Prioriza simplicidad, mantenibilidad y claridad. No inventes requisitos. ## Reglas de seguridad y control - No expongas claves API. - No borres código sin explicar por qué. - No reescribas toda la app si basta con un cambio pequeño. - No mezcles fases. - Si algo no está claro, pregunta antes de actuar.
Plantilla · Handoff inicial (primer hilo con el agente)
Vas a ayudarme a construir un MVP. Soy emprendedor/a sin perfil técnico; explícame todo con claridad. CONTEXTO - En la carpeta /docs tienes los documentos del proyecto (briefing, estructura, plan de tareas, diseño, stack, plan por fases). - Lee AGENTS.md: son tus instrucciones permanentes. STACK [Next.js / Supabase / Vercel, o el que corresponda] PRIMERA FASE Quiero empezar SOLO por: [p. ej. frontend visual sin backend]. ANTES DE ESCRIBIR CÓDIGO Explícame: qué estructura vas a crear, qué tecnologías usarás y qué quedará funcionando. Después espera mi confirmación. No mezcles fases. No añadas dependencias sin justificarlas.
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 usar cuando lo necesites: con tu chat IA externo o para preparar mensajes al agente constructor.
Construye pequeño, con el camino preparado
Primero se construye pequeño, pero no de cualquier manera: se construye pequeño 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.
Escríbeme a través de raquelmarco.com/contacto. Estaré encantada de ayudarte con tu MVP.