Revisão de Fundamentos Frontend
"Um componente deve fazer UMA coisa bem. Se você está descrevendo-o com 'e', divida-o."
Quando Aplicar
Ative esta skill ao revisar:
- Componentes React/Vue/Svelte
- Lógica de renderização de UI
- Código de gerenciamento de estado
- Decisões de CSS/estilização
- Roteamento do lado do cliente
Checklist de Revisão
Arquitetura de Componentes
- Responsabilidade Única: Cada componente faz UM trabalho?
- Verificação de Tamanho: O componente tem menos de 200 linhas?
- Contagem de Props: Existem menos de 7 props?
- Nomeação: Você consegue descrever o componente sem usar "e"?
Gerenciamento de Estado
- Colocalização: O estado está o mais próximo possível de onde é usado?
- Elevação: O estado é compartilhado corretamente entre irmãos via pai?
- Context vs Props: O prop drilling é evitado (máximo de 3 níveis)?
- Estado do Servidor: Os dados do servidor são gerenciados separadamente (React Query/SWR)?
Desempenho
- Memoização: Cálculos caros estão encapsulados em useMemo?
- Callbacks: Handlers de eventos estão encapsulados em useCallback onde necessário?
- Re-renderizações: Isso causará re-renderizações desnecessárias?
- Carregamento Preguiçoso: Componentes pesados estão divididos em chunks de código?
Acessibilidade
- HTML Semântico: Elementos apropriados estão sendo usados (button vs div)?
- ARIA: Elementos interativos são acessíveis?
- Teclado: Os usuários conseguem navegar sem usar o mouse?
Erros Comuns (Anti-Padrões)
1. Componentes Gigantes (God Components)
❌ UserDashboard.tsx (1000 linhas)
- busca dados, gerencia estado, renderiza UI, lida com roteamento
✅ Dividir em:
- UserDashboardPage.tsx (container)
- UserStats.tsx (apresentação)
- UserActivity.tsx (apresentação)
- useUserData.ts (hook)
2. Lógica na Renderização
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. Prop Drilling
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // em Widget.tsx
4. Sopa de Props Booleanos
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
Perguntas Socráticas
Faça estas perguntas ao júnior em vez de dar respostas:
- Arquitetura: "Qual é o ÚNICO trabalho deste componente?"
- Divisão: "Se eu pedisse para usar apenas a parte do cabeçalho em outro lugar, você conseguiria?"
- Estado: "Quem precisa desses dados? Eles devem viver aqui ou mais acima?"
- Desempenho: "O que acontece quando o pai é re-renderizado?"
- Complexidade: "Um novo desenvolvedor entenderia isso em 5 minutos?"
Referência de Padrões
Veja padrões detalhados em:
/standards/frontend/component-architecture.md
Bandeiras Vermelhas para Sinalizar
| Bandeira | Pergunta a Fazer |
|---|---|
| Arquivo > 200 linhas | "Podemos dividir isso em partes menores?" |
| > 5 chamadas useState | "Parte desse estado deveria ser elevada ou combinada?" |
| useEffect com [] deps mas usa valores externos | "Estamos perdendo dependências?" |
| Manipulação direta do DOM | "Existe uma maneira React de fazer isso?" |
| Estilos inline em todo lugar | "Deveríamos usar uma abordagem de estilização consistente?" |