🚀 AI Product Development Toolkit — De la Idea al Lanzamiento con 6 Prompts
Un proceso completo, no una colección de prompts
TechNomadCode/AI-Product-Development-Toolkitconvierte una idea difusa en un producto planificado y construido, con el agente como guía.
- Autor: Oualid Faouzi (ingeniero full-stack, PromptQuick · Ámsterdam).
- Escala: 1.036 ⭐ y 170 forks; MIT; actualizado el 17-oct-2026 y 0 issues abiertos.
- Cuatro piezas: 6 prompts de planificación · AI App Starter (Next.js + Supabase + Vercel) · 8 skills · 3 configuraciones de
CLAUDE.md.- Idea central: el prompt te entrevista antes de escribir. Nada de rellenar huecos con inventos.
No es una plantilla de código
El starter no trae código: trae instrucciones por etapas, reglas de permisos y requisitos de test. El agente escribe la app, los tests y el CI. Eso es una decisión de diseño, no una carencia — pero si buscabas un repo para clonar y arrancar, esto no es.
🎯 El problema que resuelve
Casi todos los prompts de producto dicen «escribe un PRD». El modelo obedece y rellena los huecos con suposiciones. Este toolkit invierte el orden:
- Pregunta antes de escribir: unas pocas preguntas concretas por turno.
- Confirma lo que entendió: declara supuestos y los valida contigo.
- Redacta solo cuando aceptas: el documento sale de tus respuestas.
- Cada paso alimenta el siguiente: el PRD usa la investigación, el UX usa el PRD, el MVP usa ambos.
flowchart LR I["💡 Idea"] --> R["1 · User research"] R --> P["2 · PRD"] P --> U["3 · UX y flujos"] U --> M["4 · MVP scope"] M --> B["5 · MVP plan"] B --> T["6 · Test plan"] T --> A["🤖 AI App Starter"] A --> L["🚀 Lanzamiento"]
📝 Los 6 prompts de planificación
Funcionan en cualquier chat de IA, no solo en Claude.
| Paso | Prompt | Le das | Te devuelve |
|---|---|---|---|
| 1 | User research | Un brief y luego las respuestas | Cuestionario + resumen de evidencia para el PRD |
| 2 | PRD | Tus notas, aunque estén crudas | Documento de requisitos: objetivos, usuarios, alcance, restricciones |
| 3 | UX y flujos | Tu PRD | Journeys, pantallas y requisitos de interfaz |
| 4 | MVP scope | PRD (+ UX si lo tienes) | La primera hipótesis a probar y qué entra o no |
| 5 | MVP plan | PRD + MVP scope | Plan completo o spec ultra-lean para una primera versión rápida |
| 6 | Test plan | Lo que quieres probar | Alcance, tipos de test, entornos y criterios de entrada/salida |
Cómo están construidos
Cada prompt sigue la misma anatomía:
ROLE → quién es el modelo (PM, investigador, diseñador)
GOAL → qué documento se va a producir
PROCESS → reglas de entrevista, una pregunta a la vez, supuestos explícitos
INPUT → tus documentos o notas
TASK NOW → la primera acción concreta
STRUCTURE → el esqueleto exacto del entregable
TONE → tono y restriccionesEso es lo que los hace reutilizables: puedes cambiar el STRUCTURE y mantener el mecanismo de entrevista.
Empieza por el paso 2
El propio autor lo dice: la mayoría no necesita investigación formal. Si tienes usuarios a mano, haz el paso 1; si no, empieza por el PRD y sigue.
🤖 AI App Starter: Next.js + Supabase + Vercel
El starter convierte al agente en un guía que construye contigo, desde la idea hasta producción. Cinco etapas:
| Etapa | Qué hace el agente | Qué haces tú |
|---|---|---|
| 1. Plan | Pide PRD, scope o notas que ya tengas y entrevista solo para llenar huecos | Responder |
| 2. Decide | Fija lo mínimo para construir: usuarios, datos, idiomas, servicios | Responder unas preguntas |
| 3. Set up | Construye la primera feature completa, con tests, checks en GitHub y pipeline de staging/producción | Crear cuentas, seguir pasos, push |
| 4. Build | Una pieza por sesión, con tests; auth, pagos, DB y datos reales pasan por revisión independiente | Revisar y push |
| 5. Launch | Prepara producción, monitorización, seguridad, SEO, páginas legales y cutover | Pasos hospedados |
Lo que copia en tu proyecto
tu-proyecto/
├── AGENTS.md reglas de cada sesión (CLAUDE.md lo importa)
├── docs/plan.md etapa actual, siguiente acción, piezas de trabajo
├── docs/decisions.md decisiones + lista "Deferred" con su momento
├── docs/product/ PRD, MVP scope y flujos UX
├── KNOWN-ISSUES.md problemas abiertos
├── .kit/stages/ 5 archivos de instrucciones, uno por etapa
├── .kit/modules/ pagos, email y background jobs
├── .kit/planning/ prompts de PRD, UX y MVP
├── .claude/settings.json deniega push, deploy y comandos hospedados
├── .codex/rules/ lo mismo para Codex
└── .gitattributes fines de línea consistentes (Windows incluido)El modelo de seguridad
Esto es lo mejor del repo:
- Nunca tiene credenciales de producción, ni siquiera de test.
- Desarrollo contra DB local y servicios de pago/email simulados.
- En la etapa 3 el agente construye un environment guard que se niega a correr contra otra cosa.
- Staging y producción solo cambian por CI o por ti.
- Los comandos bloqueados son un backstop, no la defensa principal.
Lo que sí está probado
Claude Code desktop, de setup a primera feature y primeras piezas de una tienda (catálogo, fotos, carrito), con checks en GitHub pasando al primer push.
promptquick.aicorre sobre el starter desde septiembre de 2026, con staging y producción reales.No probado: Codex y la etapa de lanzamiento.
🧩 Las 8 skills
Instalación en una línea, dentro de Claude Code o Codex:
Install the AI Product Development Toolkit skills: clone https://github.com/TechNomadCode/AI-Product-Development-Toolkit with git clone --depth 1 into a temporary folder, then follow agent-skills/INSTALL.md from it.| Skill | Claude Code | Codex | Qué hace |
|---|---|---|---|
| User research | /user-research | $user-research | Cuestionario → input para el PRD |
| PRD | /prd | $prd | Entrevista y redacta requisitos |
| UX | /ux | $ux | Pantallas y flujos desde el PRD |
| MVP scope | /mvp-scope | $mvp-scope | La versión mínima que merece la pena |
| MVP plan | /mvp-plan | $mvp-plan | Plan completo o spec lean |
| Test plan | /test-plan | $test-plan | Alcance, tipos y criterios |
| AI App Starter | /nextjs-supabase-vercel | $nextjs-supabase-vercel | Prepara una carpeta vacía con el starter |
| Video | /remotion-video | $remotion-video | Vídeo corto del producto en código (Remotion) |
Se copian a ~/.claude/skills/ o ~/.agents/skills/ y funcionan en todos los proyectos. El INSTALL.md incluye una regla importante: no sobrescribe skills tuyas con el mismo nombre; si encuentra una, la salta y te avisa.
La skill de vídeo pide Node y Python
Instala Remotion por su cuenta tras aprobar el plan. Es la única que no es de planificación y la que más dependencias mueve.
⚙️ Las 3 configuraciones de CLAUDE.md
| Config | Para qué |
|---|---|
| Sonnet 5.5 (la más reciente) | La de Opus 5.5 + tres añadidos: nada de extras no pedidos, parar tras dar un plan, y ejecutar un check real antes de decir «hecho» |
| Opus 5.5 | Alcance claro, respuestas concisas y consulta de docs actualizadas con Context7 |
| Opus 5 | La misma idea, escrita para Opus 5 |
El archivo de Sonnet es el más interesante: añade exactamente las tres correcciones que Anthropic documenta para ese modelo (tendencia a añadir tests/docs no pedidos, a convertir una lluvia de ideas en una build, y a declarar «hecho» sin comprobar).
Honestidad poco habitual
El README dice literalmente: «es una configuración personal basada en la documentación de Anthropic, no un preset oficial ni una mejora de rendimiento probada». Y recuerda que
CLAUDE.mdes contexto, no una política de permisos: lo que deba cumplirse va enpermissionso en hooks.
✅ Requisitos
- Node.js, Git y Docker.
- Opcional: Context7 para que el agente consulte docs actuales más rápido.
- Cuentas de GitHub, Vercel y Supabase recién al final de la etapa 3.
- Presupuesto: los planes gratis pueden no permitir una tienda o varios proyectos.
⚖️ Lectura crítica
Lo bueno:
- Entrevista antes de escribir: el mecanismo correcto para planificar con IA, y funciona en cualquier modelo.
- Proceso completo y encadenado, no prompts sueltos: research → PRD → UX → scope → plan → test.
- Seguridad bien pensada: sin claves hospedadas, DB local, pagos simulados, environment guard y CI como única vía a producción.
- Documentación honesta: dice qué está probado y qué no, sin inflar cifras.
- Instalación limpia y no destructiva para skills.
- MIT y sin dependencias raras.
Lo que hay que tener en cuenta:
- La etapa de lanzamiento no está probada. El propio README lo admite.
- Codex no está probado. Hay reglas y estructura, pero sin validación.
- No hay código de app: el resultado depende de que el agente siga bien las instrucciones. Con un modelo flojo, el proceso se cae.
- Es un proyecto de una persona (29 seguidores, 8 repos). Muy cuidado, pero sin equipo detrás.
- Los prompts son largos y opinados: mucho markdown y preguntas. Si buscas rapidez, se te va a hacer pesado.
- Las configs de
CLAUDE.mdcaducan: están atadas a Sonnet 5.5 / Opus 5.5 y a docs de septiembre de 2026. - No hay benchmarks: las mejoras que cita son de la guía de Anthropic, no mediciones propias.
- Depende de Supabase + Vercel: si tu stack es otro, el starter no aplica; los prompts sí.
La lectura de fondo
Esto es lo contrario a los catálogos masivos: pocas piezas, bien pensadas y con el proceso explícito. Lo más valioso no es el starter de Next.js — es el mecanismo de entrevista y la disciplina de escribir
docs/plan.mdydocs/decisions.md. Eso se puede portar a cualquier stack, incluido tu bóveda y tus agentes actuales.
🔗 Enlaces
- Repositorio — AI Product Development Toolkit
- Prompts de planificación
- AI App Starter
- Instalación de skills
- Configuraciones de Claude Code
- PromptQuick
🔗 Notas relacionadas
- 🧠 Claude Code Best Practices — las primitivas que este toolkit usa por debajo.
- 🧰 Awesome Claude Code Toolkit — el kit de arranque técnico; este es el de producto.
- 🧰 Claude Skills (Rezvani) — catálogo masivo frente a proceso curado.
- 📚 Context7 — el MCP que las configs usan para consultar docs actuales.
- 📋 It’s a Plan — otra forma de organizar el trabajo con agentes.
- 📥 Vault Ingest — cómo se guardó esta nota.