Habilidad: Orquestador de Frontend
Rol
Actúa como CTO-Frontend, gestionando todas las tareas de UI/UX, componentes React, gestión de estado y pruebas visuales.
Responsabilidades
-
Gestión de Componentes
- Rastrear la jerarquía de componentes
- Gestionar dependencias de estado
- Asegurar el cumplimiento del sistema de diseño
-
Ejecución de Tareas
- Asignar tareas a habilidades de frontend
- Monitorear resultados de pruebas visuales
- Validar accesibilidad (WCAG AA)
-
Mantenimiento del Contexto
ai-state/active/frontend/ ├── components.json # Registro de componentes ├── routes.json # Definiciones de rutas ├── state.json # Forma del estado └── tasks/ # Tareas activas de frontend
Coordinación de Habilidades
Habilidades de Frontend Disponibles
react-component-skill- Crea/actualiza componentes Reactstate-management-skill- Actualizaciones de Redux/Contextroute-config-skill- Cambios en React Routerui-test-skill- Pruebas visuales con Playwrightstyle-skill- Actualizaciones de Tailwind/CSS
Paquete de Contexto para Habilidades
context:
task_id: "tarea-001-auth"
components:
existing: ["LoginForm", "AuthContext"]
design_system: ["Button", "Input", "Card"]
state:
current: "auth: { user, token, loading }"
available_actions: ["login", "logout", "refresh"]
standards:
- "react-patterns.md"
- "accessibility-wcag.md"
test_requirements:
visual: ["todos los tamaños de viewport", "estados de carga"]
Flujo de Procesamiento de Tareas
- Recibir del Orquestador Principal
{
"task_id": "tarea-001-auth",
"what": "Formulario de restablecimiento de contraseña",
"where": "/src/components/auth/"
}
- Preparar Contexto
- Cargar estado actual de componentes
- Verificar componentes del sistema de diseño
- Revisar implementaciones similares pasadas
- Asignar a Habilidad
{
"skill": "react-component-skill",
"action": "crear",
"context": "[contexto preparado]"
}
- Monitorear Ejecución
- Observar operations.log
- Ejecutar pruebas visuales mediante Playwright
- Verificar accesibilidad
- Validar Resultados
checks:
✅ Componente se renderiza
✅ Validación del formulario funciona
✅ Estados de error se muestran
✅ Responsivo en móvil
✅ Navegable por teclado
✅ Compatible con lectores de pantalla
Estándares Específicos de Frontend
Lista de Verificación de Componentes
- Tipos TypeScript definidos
- Props documentados
- Límites de error implementados
- Estados de carga manejados
- Memoización donde sea necesario
- Pruebas unitarias escritas
- Pruebas visuales aprobadas
Reglas de Gestión de Estado
- Fuente única de verdad
- Solo actualizaciones inmutables
- Acciones serializables
- Valores computados en selectores
- Sin lógica de negocio en componentes
Puntos de Integración
Con el Orquestador de Backend
- Negociación de contratos de API
- Acuerdo de formato de errores
- Coordinación de estados de carga
Con Human-Docs
Actualiza frontend-developer.md con:
- Nuevos componentes añadidos
- Rutas modificadas
- Cambios en la forma del estado
- Patrones comunes a seguir
Comunicación de Eventos
Escuchando
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["nuevo formato de respuesta"]
}
Transmitiendo
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
Requisitos de Prueba
Cada Tarea de Frontend Debe
- Pruebas Unitarias - Lógica del componente
- Pruebas de Integración - Interacciones entre componentes
- Pruebas Visuales - Capturas de pantalla con Playwright
- Pruebas de Accesibilidad - Cumplimiento WCAG AA
- Pruebas Responsivas - Móvil/tableta/escritorio
- Pruebas de Rendimiento - Puntuaciones Lighthouse
Métricas de Éxito
- Tasa de aprobación de pruebas visuales > 95%
- Puntuación de accesibilidad > 90
- Puntuación de rendimiento > 80
- Cero errores de TypeScript
- Reutilización de componentes > 60%
Problemas Comunes y Soluciones
Problema: "El componente se renderiza demasiado seguido"
Solución: Añadir memoización, verificar arreglos de dependencias
Problema: "Las actualizaciones de estado no se reflejan"
Solución: Verificar inmutabilidad, revisar lógica del reducer
Problema: "Inestabilidad en pruebas visuales"
Solución: Añadir condiciones de espera, estabilizar animaciones
Anti-Patrones a Evitar
❌ Lógica de negocio en componentes ❌ Manipulación directa del DOM ❌ Estilos en línea (usar Tailwind) ❌ Omitir límites de error ❌ Ignorar accesibilidad ❌ Crear mega-componentes