01 El problema que resuelve
Pedir a un agente «hazme una app de reservas» suele acabar igual: algo que funciona a medias, con funciones que no pediste y sin las que necesitabas. El agente rellena los huecos con suposiciones y tú pierdes el control del producto.
Este prompt reparte los papeles: tú eres el responsable de producto y tomas las decisiones de negocio; la IA hace de cofundador técnico que pregunta, propone, construye por partes y se detiene cuando hay que decidir.
Alcance realista
Separa lo imprescindible para la primera versión de lo que puede esperar.
Visibilidad
Construye por etapas que puedes revisar, no un bloque enorme al final.
Decisiones tuyas
Cada bifurcación importante llega con opciones y sus pros y contras.
Entrega completa
Instrucciones de uso, mantenimiento y despliegue para no depender de la conversación.
02 Las cinco fases
| Fase | Qué ocurre | Qué decides tú |
|---|---|---|
| Descubrimiento | La IA pregunta por el problema, el usuario y el contexto, y cuestiona supuestos débiles | Para quién es y qué problema resuelve |
| Plan de la v1 | Propone qué entra y qué no, enfoque técnico explicado sin jerga, complejidad y dependencias | El alcance final y las cuentas o servicios que aceptas |
| Construcción | Avanza por etapas, prueba cada una y se para en los puntos de decisión | Si cada etapa cumple antes de seguir |
| Pulido | Errores bien gestionados, casos límite, versión móvil y detalles de acabado | Qué nivel de acabado necesitas |
| Entrega | Despliegue si lo quieres publicar, documentación y propuestas para la v2 | Cuándo se publica y qué viene después |
03 El prompt de arranque
Rellena los corchetes antes de pegarlo. Si alguna respuesta no la tienes clara, déjala en blanco: la fase de descubrimiento sirve justo para eso.
Vas a ser mi cofundador técnico. Tú construyes; yo decido como responsable de producto.
Contexto:
- Idea: [qué quieres construir]
- Para quién: [usuario principal]
- Problema que resuelve: [qué le duele hoy y cómo lo resuelve ahora]
- Ambición: [probar una idea / uso propio / compartir con clientes / lanzar al mercado]
- Tiempo y presupuesto: [horas y gasto mensual aceptable en servicios]
- Preferencias o restricciones: [tecnologías, herramientas que ya pago, requisitos legales]
Trabaja por fases y no pases a la siguiente sin mi visto bueno:
1. Descubrimiento. Hazme las preguntas necesarias, de pocas en pocas, para entender qué necesito de verdad. Señala contradicciones o ideas demasiado amplias y propón un punto de partida más pequeño.
2. Plan de la v1. Lista lo que entra y lo que queda para después, explica el enfoque técnico en lenguaje llano, estima la complejidad (baja, media o alta) y dime qué cuentas, servicios o claves necesitaré y cuánto cuestan. Describe cómo se verá y se usará el resultado.
3. Construcción. Avanza por etapas pequeñas. En cada una: qué vas a hacer y por qué, hazlo, pruébalo y enséñame cómo comprobarlo yo. Si aparece un bloqueo, dame dos o tres salidas con sus ventajas e inconvenientes.
4. Pulido. Gestiona errores y casos límite, revisa la versión móvil si aplica y deja la interfaz con aspecto de producto terminado.
5. Entrega. Si lo quiero publicar, guíame en el despliegue. Escribe un documento con cómo usarlo, cómo mantenerlo, las decisiones importantes y propuestas para la v2.
Reglas: habla claro y traduce los tecnicismos; avísame si estoy complicando algo; sé honesto con los límites y riesgos; nunca pegues claves ni contraseñas en el código.
Empieza por la fase 1.04 Cómo usarlo en Claude Code
-
1
Crea una carpeta para el proyecto
Una carpeta vacía por producto. Abre Claude Code en ella desde la terminal con el comando claude o desde la app de escritorio.
-
2
Activa el modo plan para las dos primeras fases
Pulsa Shift+Tab hasta ver el modo plan o empieza el mensaje con /plan. Claude investigará y propondrá sin tocar archivos hasta que apruebes.
-
3
Pega el prompt
Responde a las preguntas del descubrimiento. Cuando el plan de la v1 te convenza, apruébalo.
-
4
Guarda el plan en el repositorio
Pide que escriba el alcance y las decisiones en un archivo (por ejemplo PLAN.md) y un resumen de las reglas en CLAUDE.md, para que una sesión nueva retome el trabajo sin perder contexto.
-
5
Construye etapa a etapa
Revisa cada etapa, prueba lo que te indique y pide un commit de Git al cerrar cada una. Así puedes volver atrás si algo se rompe.
Lee PLAN.md y CLAUDE.md y el historial de commits. Resúmeme en qué fase y etapa estamos, qué quedó pendiente y cuál es el siguiente paso. No escribas código hasta que te lo confirme.05 Si no usas un agente de código
El prompt también funciona en el chat de Claude para proyectos sencillos: una calculadora para tu web, una plantilla de hoja de cálculo o una pequeña página que Claude puede mostrar como artefacto. La diferencia es que tendrás que copiar el resultado a mano y no podrá ejecutar pruebas en tu ordenador. Para algo que vaya a tener usuarios reales, un agente de código como Claude Code es la opción adecuada.
06 Errores típicos
- ✓Saltarse el descubrimiento porque «ya sé lo que quiero».
- ✓Aceptar todas las funciones propuestas: cada una es más código que mantener.
- ✓Aprobar etapas sin probarlas tú mismo en el navegador o el móvil.
- ✓Mezclar cambios de alcance en mitad de una etapa en vez de anotarlos para la siguiente.
- ✓Publicar sin revisar permisos, copias de seguridad y gestión de datos personales.
- ✓No guardar el plan en archivos y depender de una conversación que acabará compactándose.
Preguntas frecuentes
No para empezar. El prompt pide explicaciones en lenguaje llano y que te diga cómo comprobar cada etapa. Sí necesitarás criterio de producto y paciencia para probar.
Sí. Cambia el contexto inicial por una descripción de lo que ya hay y pide que empiece leyendo el código y proponiendo qué mejorar en la siguiente versión.
Porque cada respuesta cambia las siguientes preguntas. Un cuestionario largo de golpe lleva a respuestas superficiales.
Pídele que relea PLAN.md, compare lo hecho con lo acordado y deshaga lo que no estaba aprobado. Para eso sirven los commits por etapa.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.