Fluxo de Trabalho de Desenvolvimento React/Next.js
Regra de Leitura Seletiva
Comece com:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Em seguida, carregue apenas os documentos herdados, scripts, ativos ou exemplos que correspondam à tarefa real do usuário.
Visão Geral
Fluxo de trabalho especializado para construir aplicações React e Next.js 14+ com padrões modernos, incluindo App Router, Server Components, TypeScript e Tailwind CSS.
Quando Usar Este Fluxo de Trabalho
Use este fluxo de trabalho quando:
- Construindo novas aplicações React
- Criando projetos Next.js 14+ com App Router
- Implementando Server Components
- Configurando TypeScript com React
- Estilizando com Tailwind CSS
- Construindo aplicações Next.js full-stack
Fases do Fluxo de Trabalho
Fase 1: Configuração do Projeto
Skills a Invocar
app-builder- Scaffolding de aplicaçãosenior-fullstack- Orientação full-stacknextjs-app-router-patterns- Padrões Next.js 14+typescript-pro- Configuração TypeScript
Ações
- Escolher tipo de projeto (React SPA, app Next.js)
- Selecionar ferramenta de build (Vite, Next.js, Create React App)
- Scaffold da estrutura do projeto
- Configurar TypeScript
- Configurar ESLint e Prettier
Prompts de Copiar e Colar
Use @app-builder para fazer scaffold de um novo projeto Next.js 14 com App Router
Use @nextjs-app-router-patterns para configurar Server Components
Fase 2: Arquitetura de Componentes
Skills a Invocar
frontend-developer- Desenvolvimento de componentesreact-patterns- Padrões Reactreact-state-management- Gerenciamento de estadoreact-ui-patterns- Padrões de UI
Ações
- Projetar hierarquia de componentes
- Criar componentes base
- Implementar componentes de layout
- Configurar gerenciamento de estado
- Criar hooks personalizados
Prompts de Copiar e Colar
Use @frontend-developer para criar componentes React reutilizáveis
Use @react-patterns para implementar composição de componentes adequada
Use @react-state-management para configurar store Zustand
Fase 3: Estilização e Design
Skills a Invocar
frontend-design- Design de UItailwind-patterns- Tailwind CSStailwind-design-system- Sistema de designcore-components- Biblioteca de componentes
Ações
- Configurar Tailwind CSS
- Configurar tokens de design
- Criar classes utilitárias
- Construir estilos de componentes
- Implementar design responsivo
Prompts de Copiar e Colar
Use @tailwind-patterns para estilizar componentes com Tailwind CSS v4
Use @frontend-design para criar uma UI de dashboard moderna
Fase 4: Busca de Dados
Skills a Invocar
nextjs-app-router-patterns- Server Componentsreact-state-management- React Queryapi-patterns- Integração de API
Ações
- Implementar Server Components
- Configurar React Query/SWR
- Criar cliente de API
- Lidar com estados de carregamento
- Implementar boundaries de erro
Prompts de Copiar e Colar
Use @nextjs-app-router-patterns para implementar busca de dados com Server Components
Fase 5: Roteamento e Navegação
Skills a Invocar
nextjs-app-router-patterns- App Routernextjs-best-practices- Padrões Next.js
Ações
- Configurar roteamento baseado em arquivos
- Criar rotas dinâmicas
- Implementar rotas aninhadas
- Adicionar guards de rota
- Configurar redirecionamentos
Prompts de Copiar e Colar
Use @nextjs-app-router-patterns para configurar rotas paralelas e rotas de interceptação
Fase 6: Formulários e Validação
Skills a Invocar
frontend-developer- Desenvolvimento de formuláriostypescript-advanced-types- Validação de tiposreact-ui-patterns- Padrões de formulários
Ações
- Escolher biblioteca de formulários (React Hook Form, Formik)
- Configurar validação (Zod, Yup)
- Criar componentes de formulário
- Lidar com submissões
- Implementar tratamento de erros
Prompts de Copiar e Colar
Use @frontend-developer para criar formulários com React Hook Form e Zod
Fase 7: Testes
Skills a Invocar
javascript-testing-patterns- Jest/Vitestplaywright-skill- Testes E2Ee2e-testing-patterns- Padrões E2E
Ações
- Configurar framework de testes
- Escrever testes unitários
- Criar testes de componentes
- Implementar testes E2E
- Configurar integração CI
Prompts de Copiar e Colar
Use @javascript-testing-patterns para escrever testes com Vitest
Use @playwright-skill para criar testes E2E para fluxos críticos
Fase 8: Build e Deploy
Skills a Invocar
vercel-deployment- Deploy na Vercelvercel-deploy-claimable- Deploy na Vercelweb-performance-optimization- Performance
Ações
- Configurar configurações de build
- Otimizar tamanho do bundle
- Configurar variáveis de ambiente
- Fazer deploy na Vercel
- Configurar deploys de preview
Prompts de Copiar e Colar
Use @vercel-deployment para fazer deploy do app Next.js em produção
Stack de Tecnologias
| Categoria | Tecnologia |
|---|---|
| Framework | Next.js 14+, React 18+ |
| Linguagem | TypeScript 5+ |
| Estilização | Tailwind CSS v4 |
| Estado | Zustand, React Query |
| Formulários | React Hook Form, Zod |
| Testes | Vitest, Playwright |
| Deploy | Vercel |
Gates de Qualidade
- TypeScript compila sem erros
- Todos os testes passando
- Linting limpo
- Métricas de performance atendidas (LCP, CLS, FID)
- Acessibilidade verificada (WCAG 2.1)
- Design responsivo verificado
Pacotes de Fluxo de Trabalho Relacionados
development- Desenvolvimento geraltesting-qa- Fluxo de testedocumentation- Documentaçãotypescript-development- Padrões TypeScript
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica de ambiente, testes ou revisão especializada.
- Pare e peça esclarecimentos se entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.