Revisión de Fundamentos Frontend
"Un componente debe hacer UNA cosa bien. Si lo describes con 'y', divídelo."
Cuándo Aplicarlo
Activa este skill al revisar:
- Componentes React/Vue/Svelte
- Lógica de renderizado de UI
- Código de gestión de estado
- Decisiones de CSS/estilos
- Enrutamiento del lado del cliente
Lista de Verificación de Revisión
Arquitectura de Componentes
- Responsabilidad Única: ¿Cada componente hace UNA sola tarea?
- Verificación de Tamaño: ¿El componente tiene menos de 200 líneas?
- Cantidad de Props: ¿Hay menos de 7 props?
- Nombrado: ¿Puedes describir el componente sin usar la palabra "y"?
Gestión de Estado
- Colocación: ¿El estado está lo más cerca posible de donde se usa?
- Elevación: ¿El estado se comparte correctamente entre hermanos a través del padre?
- Context vs Props: ¿Se evita el prop drilling (máximo 3 niveles)?
- Estado del Servidor: ¿Los datos del servidor se gestionan por separado (React Query/SWR)?
Rendimiento
- Memoización: ¿Los cálculos costosos están envueltos en useMemo?
- Callbacks: ¿Los manejadores de eventos están envueltos en useCallback donde sea necesario?
- Re-renderizados: ¿Esto causará re-renderizados innecesarios?
- Carga Perezosa: ¿Los componentes pesados están divididos en chunks de código?
Accesibilidad
- HTML Semántico: ¿Se usan elementos adecuados (button vs div)?
- ARIA: ¿Los elementos interactivos son accesibles?
- Teclado: ¿Pueden los usuarios navegar sin ratón?
Errores Comunes (Antipatrones)
1. Componentes Dios
❌ UserDashboard.tsx (1000 líneas)
- obtiene datos, gestiona estado, renderiza UI, maneja enrutamiento
✅ Dividir en:
- UserDashboardPage.tsx (contenedor)
- UserStats.tsx (presentación)
- UserActivity.tsx (presentación)
- useUserData.ts (hook)
2. Lógica en el Renderizado
❌ 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(); // en Widget.tsx
4. Sopa de Props Booleanas
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
Preguntas Socráticas
Haz estas preguntas al junior en lugar de dar respuestas:
- Arquitectura: "¿Cuál es la ÚNICA tarea de este componente?"
- División: "Si te pidiera usar solo la parte del encabezado en otro lugar, ¿podrías?"
- Estado: "¿Quién necesita estos datos? ¿Deberían vivir aquí o más arriba?"
- Rendimiento: "¿Qué sucede cuando el padre se vuelve a renderizar?"
- Complejidad: "¿Podría un desarrollador nuevo entender esto en 5 minutos?"
Referencia de Estándares
Consulta patrones detallados en:
/standards/frontend/component-architecture.md
Banderas Rojas a Señalar
| Banderas | Pregunta a Hacer |
|---|---|
| Archivo > 200 líneas | "¿Podemos dividir esto en partes más pequeñas?" |
| > 5 llamadas a useState | "¿Debería elevarse o combinarse parte de este estado?" |
| useEffect con [] pero usa valores externos | "¿Faltan dependencias?" |
| Manipulación directa del DOM | "¿Hay una forma React de hacer esto?" |
| Estilos en línea por todas partes | "¿Deberíamos usar un enfoque de estilos consistente?" |