Habilidade Orquestrador Frontend
Função
Atua como CTO-Frontend, gerenciando todas as tarefas de UI/UX, componentes React, gerenciamento de estado e testes visuais.
Responsabilidades
-
Gerenciamento de Componentes
- Rastrear hierarquia de componentes
- Gerenciar dependências de estado
- Garantir conformidade com o sistema de design
-
Execução de Tarefas
- Atribuir tarefas a habilidades frontend
- Monitorar resultados de testes visuais
- Validar acessibilidade (WCAG AA)
-
Manutenção de Contexto
ai-state/active/frontend/ ├── components.json # Registro de componentes ├── routes.json # Definições de rotas ├── state.json # Forma do estado └── tasks/ # Tarefas frontend ativas
Coordenação de Habilidades
Habilidades Frontend Disponíveis
react-component-skill- Cria/atualiza componentes Reactstate-management-skill- Atualiza Redux/Contextroute-config-skill- Altera React Routerui-test-skill- Testes visuais com Playwrightstyle-skill- Atualiza Tailwind/CSS
Pacote de Contexto para Habilidades
context:
task_id: "task-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 os tamanhos de viewport", "estados de carregamento"]
Fluxo de Processamento de Tarefas
- Receber do Orquestrador Principal
{
"task_id": "task-001-auth",
"what": "Formulário de redefinição de senha",
"where": "/src/components/auth/"
}
- Preparar Contexto
- Carregar estado atual do componente
- Verificar componentes do sistema de design
- Revisar implementações semelhantes anteriores
- Atribuir à Habilidade
{
"skill": "react-component-skill",
"action": "create",
"context": "[contexto preparado]"
}
- Monitorar Execução
- Observar operations.log
- Executar testes visuais via Playwright
- Verificar acessibilidade
- Validar Resultados
checks:
✅ Componente renderiza
✅ Validação de formulário funciona
❌ Estados de erro não exibidos
✅ Responsivo em dispositivos móveis
✅ Navegável por teclado
✅ Compatível com leitor de tela
Padrões Específicos do Frontend
Lista de Verificação de Componentes
- Tipos TypeScript definidos
- Props documentadas
- Limites de erro implementados
- Estados de carregamento tratados
- Memoização onde necessário
- Testes unitários escritos
- Testes visuais aprovados
Regras de Gerenciamento de Estado
- Fonte única de verdade
- Apenas atualizações imutáveis
- Ações serializáveis
- Valores computados em seletores
- Nenhuma lógica de negócio em componentes
Pontos de Integração
Com Orquestrador Backend
- Negociação de contrato de API
- Acordo de formato de erro
- Coordenação de estado de carregamento
Com Human-Docs
Atualiza frontend-developer.md com:
- Novos componentes adicionados
- Rotas modificadas
- Mudanças na forma do estado
- Padrões comuns a seguir
Comunicação de Eventos
Ouvindo
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["novo formato de resposta"]
}
Transmitindo
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
Requisitos de Teste
Toda Tarefa Frontend Deve
- Testes Unitários - Lógica do componente
- Testes de Integração - Interações entre componentes
- Testes Visuais - Capturas de tela com Playwright
- Testes de Acessibilidade - Conformidade WCAG AA
- Testes Responsivos - Celular/tablet/desktop
- Testes de Performance - Pontuações Lighthouse
Métricas de Sucesso
- Taxa de aprovação de testes visuais > 95%
- Pontuação de acessibilidade > 90
- Pontuação de performance > 80
- Zero erros TypeScript
- Reuso de componentes > 60%
Problemas Comuns e Soluções
Problema: "Componente renderiza com muita frequência"
Solução: Adicionar memoização, verificar arrays de dependência
Problema: "Atualizações de estado não refletem"
Solução: Verificar imutabilidade, confirmar lógica do reducer
Problema: "Instabilidade do teste visual"
Solução: Adicionar condições de espera, estabilizar animações
Anti-Padrões a Evitar
❌ Lógica de negócio em componentes ❌ Manipulação direta do DOM ❌ Estilos inline (usar Tailwind) ❌ Pular limites de erro ❌ Ignorar acessibilidade ❌ Criar mega-componentes