Flujo de Trabajo para Desarrollo con React/Next.js
Resumen
Flujo de trabajo especializado para construir aplicaciones con React y Next.js 14+ utilizando patrones modernos como App Router, Server Components, TypeScript y Tailwind CSS.
Cuándo Usar Este Flujo de Trabajo
Usa este flujo de trabajo cuando:
- Estés creando nuevas aplicaciones React
- Estés iniciando proyectos Next.js 14+ con App Router
- Implementes Server Components
- Configures TypeScript con React
- Desarrolles estilos con Tailwind CSS
- Construyas aplicaciones Next.js full-stack
Fases del Flujo de Trabajo
Fase 1: Configuración del Proyecto
Skills a Invocar
app-builder- Andamiaje de aplicacionessenior-fullstack- Guía full-stacknextjs-app-router-patterns- Patrones de Next.js 14+typescript-pro- Configuración de TypeScript
Acciones
- Elegir tipo de proyecto (React SPA, aplicación Next.js)
- Seleccionar herramienta de construcción (Vite, Next.js, Create React App)
- Andamiar estructura del proyecto
- Configurar TypeScript
- Configurar ESLint y Prettier
Indicaciones de Copia y Pegado
Usa @app-builder para andamiar un nuevo proyecto Next.js 14 con App Router
Usa @nextjs-app-router-patterns para configurar Server Components
Fase 2: Arquitectura de Componentes
Skills a Invocar
frontend-developer- Desarrollo de componentesreact-patterns- Patrones de Reactreact-state-management- Manejo de estadoreact-ui-patterns- Patrones de UI
Acciones
- Diseñar jerarquía de componentes
- Crear componentes base
- Implementar componentes de layout
- Configurar manejo de estado
- Crear hooks personalizados
Indicaciones de Copia y Pegado
Usa @frontend-developer para crear componentes React reutilizables
Usa @react-patterns para implementar composición de componentes adecuada
Usa @react-state-management para configurar un store con Zustand
Fase 3: Estilizado y Diseño
Skills a Invocar
frontend-design- Diseño UItailwind-patterns- Tailwind CSStailwind-design-system- Sistema de diseñocore-components- Librería de componentes
Acciones
- Configurar Tailwind CSS
- Configurar tokens de diseño
- Crear clases utilitarias
- Construir estilos de componentes
- Implementar diseño responsive
Indicaciones de Copia y Pegado
Usa @tailwind-patterns para estilizar componentes con Tailwind CSS v4
Usa @frontend-design para crear una UI de dashboard moderna
Fase 4: Obtención de Datos
Skills a Invocar
nextjs-app-router-patterns- Server Componentsreact-state-management- React Queryapi-patterns- Integración de API
Acciones
- Implementar Server Components
- Configurar React Query / SWR
- Crear cliente API
- Manejar estados de carga
- Implementar límites de error
Indicaciones de Copia y Pegado
Usa @nextjs-app-router-patterns para implementar obtención de datos con Server Components
Fase 5: Enrutamiento y Navegación
Skills a Invocar
nextjs-app-router-patterns- App Routernextjs-best-practices- Patrones de Next.js
Acciones
- Configurar enrutamiento basado en archivos
- Crear rutas dinámicas
- Implementar rutas anidadas
- Agregar guardias de ruta
- Configurar redirecciones
Indicaciones de Copia y Pegado
Usa @nextjs-app-router-patterns para configurar rutas paralelas e interceptación de rutas
Fase 6: Formularios y Validación
Skills a Invocar
frontend-developer- Desarrollo de formulariostypescript-advanced-types- Validación de tiposreact-ui-patterns- Patrones de formularios
Acciones
- Elegir librería de formularios (React Hook Form, Formik)
- Configurar validación (Zod, Yup)
- Crear componentes de formulario
- Manejar envíos
- Implementar manejo de errores
Indicaciones de Copia y Pegado
Usa @frontend-developer para crear formularios con React Hook Form y Zod
Fase 7: Pruebas
Skills a Invocar
javascript-testing-patterns- Jest / Vitestplaywright-skill- Pruebas E2Ee2e-testing-patterns- Patrones E2E
Acciones
- Configurar framework de pruebas
- Escribir pruebas unitarias
- Crear pruebas de componentes
- Implementar pruebas E2E
- Configurar integración con CI
Indicaciones de Copia y Pegado
Usa @javascript-testing-patterns para escribir pruebas con Vitest
Usa @playwright-skill para crear pruebas E2E para flujos críticos
Fase 8: Construcción y Despliegue
Skills a Invocar
vercel-deployment- Despliegue en Vercelvercel-deploy-claimable- Despliegue en Vercelweb-performance-optimization- Rendimiento
Acciones
- Configurar ajustes de construcción
- Optimizar tamaño del bundle
- Configurar variables de entorno
- Desplegar en Vercel
- Configurar despliegues de vista previa
Indicaciones de Copia y Pegado
Usa @vercel-deployment para desplegar la app Next.js a producción
Stack Tecnológico
| Categoría | Tecnología |
|---|---|
| Framework | Next.js 14+, React 18+ |
| Lenguaje | TypeScript 5+ |
| Estilizado | Tailwind CSS v4 |
| Estado | Zustand, React Query |
| Formularios | React Hook Form, Zod |
| Pruebas | Vitest, Playwright |
| Despliegue | Vercel |
Puertas de Calidad
- TypeScript compila sin errores
- Todas las pruebas pasan
- Linting limpio
- Métricas de rendimiento cumplidas (LCP, CLS, FID)
- Accesibilidad verificada (WCAG 2.1)
- Diseño responsive verificado
Paquetes de Flujo de Trabajo Relacionados
development- Desarrollo generaltesting-qa- Flujo de pruebasdocumentation- Documentacióntypescript-development- Patrones de TypeScript
Limitaciones
- Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
- No trates la salida como un sustituto de validaciones específicas del entorno, pruebas o revisión de expertos.
- Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.