De idea a deploy con Claude Code

Este es el workflow real que uso para construir features y proyectos completos:

1. Idea → CLAUDE.md (definir el proyecto)
2. /autopilot o /team (construir)
3. vercel --prod (deployar)

No hay CI/CD separado. No hay staging environment. No hay sprints de 2 semanas. Una idea puede estar en producción en 2-4 horas desde el primer prompt.

Empieza con un proyecto nuevo o existente:

npx create-next-app@latest mi-proyecto --typescript --tailwind --app
cd mi-proyecto
claude

Lo primero: escribe el CLAUDE.md. Claude Code lo leerá al inicio de cada sesión:

Crea un CLAUDE.md para este proyecto. Stack: Next.js con App Router,
Prisma + PostgreSQL en Neon, Tailwind CSS. Va a ser un [descripción].
El usuario es [quién]. Deploy en Vercel.

Claude genera un CLAUDE.md inicial. Revísalo y ajusta.

Si tu proyecto necesita base de datos:

Configura Prisma con PostgreSQL. Crea el schema inicial para [tu modelo].
Genera la migración y el cliente.

Claude configurará:

• prisma/schema.prisma con tus modelos
• .env con la connection string de Neon
• La primera migración con prisma migrate dev

Para Neon (PostgreSQL serverless gratuito):

1. Crea una cuenta en neon.tech
2. Copia la connection string
3. Pégala en .env como DATABASE_URL

Para features individuales, /autopilot es el camino más rápido:

/autopilot "crear el sistema de autenticación con NextAuth y Google provider"

OMC ejecuta el pipeline completo:

1. Explore — lee tu codebase, identifica archivos relevantes
2. Analyst — define criterios de aceptación
3. Planner — secuencia la implementación
4. Executor — escribe el código
5. Verifier — confirma que funciona

Para proyectos más grandes con múltiples features, usa /team:

/team "construir MVP de e-commerce: catálogo de productos, carrito,
checkout con Stripe, y dashboard de admin"

Cuando algo no funciona:

El login con Google devuelve error 500 después del callback. Investiga y arréglalo.

Si el bug es complejo, delega al debugger:

/ralph "el checkout falla cuando el carrito tiene más de 10 items.
Investiga la causa raíz, arréglalo y añade tests."

/ralph no para hasta que los tests pasan. Si el primer fix no funciona, investiga más y prueba otra cosa.

Para errores de TypeScript después de un refactor:

/build-fix

Build-fixer resuelve 15-20 errores de tipos en 3 minutos.

Con Vercel, deployar es un comando:

vercel --prod

Sin Docker. Sin nginx. Sin CI/CD YAML. Zero-config para Next.js.

Antes de deployar, verifica:

npm run build        # Build local pasa
npx tsc --noEmit     # Zero errores de tipos

Si usas Prisma, asegúrate de que la migración está aplicada en producción:

# En la build de Vercel (vercel.json o package.json scripts)
"build": "prisma generate && prisma migrate deploy && next build"

Un día típico construyendo con este workflow:

Hora	Actividad
9:00	Revisar el plan del día, actualizar CLAUDE.md
9:15	/team o /autopilot para la feature principal
10:30	Revisar outputs, ajustar, iterar
11:00	/ralph para bugs o tareas que necesitan perfección
12:00	Build, test, deploy
12:15	Feature en producción

Total de código escrito manualmente: cerca de 0 líneas. Todo lo que escribo es dirección: qué construir, qué corregir, qué priorizar.

La herramienta más importante no es Claude Code — es saber qué pedir y cuándo revisar el output.