jhow-studio-autonomous

name: jhow-studio-autonomous description: Use quando precisar de agentes autônomos para otimização de performance (app lento, bundle grande, re-renders), segurança (vulnerabilidades, secrets hardcoded), limpeza de código (código morto, refatoração), migrações, otimização geral, acessibilidade WCAG, ou internacionalização i18n/RTL.

🎭 Agentes Autônomos - Jhow Studio

Esta skill fornece acesso a 7 agentes especializados para tarefas autônomas de otimização, segurança, limpeza, migração, acessibilidade e internacionalização de código.

⚡ Matriz de Decisão Rápida

🎯 Como Selecionar o Agente Correto

1. Identifique o tipo de problema

• Leia o código ou descrição do problema
• Classifique em uma das 7 categorias acima

2. Verifique se há sobreposição

• Alguns problemas podem envolver múltiplos agentes (ex: migração + otimização)
• Priorize pelo impacto mais crítico primeiro
• Execute agentes em sequência se necessário

3. Escolha com base na prioridade

• P0 (Bloqueante): Segurança → Sentinel
• P1 (Alto): Performance → Bolt | Acessibilidade → A11y Specialist
• P2 (Médio): Limpeza → Janitor | i18n → i18n Specialist
• P3 (Baixo): Migrações → Migrator | Otimizações gerais → Optimizer

📁 Agentes Disponíveis

🔥 Bolt - Performance

Use quando:

• A aplicação está lenta ou com lag
• O bundle está muito grande
• Há re-renders excessivos
• Core Web Vitals estão ruins
• Problemas de lazy loading/code splitting

🛡️ Sentinel - Segurança

Use quando:

• Precisa escanear vulnerabilidades
• Há secrets ou credenciais hardcoded
• Dependências estão desatualizadas
• Problemas de CSP ou headers de segurança
• Potenciais XSS ou injeções

🧹 Janitor - Limpeza

Use quando:

• Há código morto ou não utilizado
• Imports não estão sendo usados
• Funções/componentes estão duplicados
• Necessário refatorar para melhor legibilidade
• Débito técnico precisa ser reduzido

🔄 Migrator - Migrações

Use quando:

• Atualizando versões (React, Next.js, TypeScript)
• Mudando de uma biblioteca para outra
• Refatorando arquitetura
• Convertendo de JavaScript para TypeScript
• Migrando para novo padrão/framework

⚙️ Optimizer - Otimização Geral

Use quando:

• Problemas não se encaixam em outras categorias
• Múltiplas pequenas otimizações necessárias
• Melhorias gerais de qualidade de código
• Otimização de queries ou chamadas API
• Melhoria de estrutura de dados

♿ A11y Specialist - Acessibilidade

Use quando:

• Problemas de conformidade WCAG
• Componentes não acessíveis a screen readers
• Falta de navegação por teclado
• Contraste de cores inadequado
• Problemas com ARIA ou semântica HTML

🌍 i18n Specialist - Internacionalização

Use quando:

• Implementando ou melhorando i18n
• Suporte a RTL (Right-to-Left)
• Problemas com traduções
• Localização de datas, números, moedas
• Detecção e switching de idiomas

🔄 Workflow Recomendado

1. ANÁLISE
   └── Identifique o problema específico
   └── Classifique em uma categoria
   └── Defina a prioridade (P0-P3)

2. SELEÇÃO
   └── Consulte a Matriz de Decisão Rápida
   └── Leia o arquivo do agente correspondente
   └── Verifique se há dependências/ordem

3. EXECUÇÃO
   └── Use o modo subagente com o agente selecionado
   └── Forneça contexto completo do problema
   └── Acompanhe a execução

4. REVISÃO
   └── Verifique as mudanças propostas
   └── Execute testes se disponíveis
   └── Valide que o problema foi resolvido

5. ITERAÇÃO (se necessário)
   └── Se novos problemas surgirem, volte ao passo 1
   └── Se múltiplos agentes necessários, execute em sequência

💡 Dicas de Uso

• Sempre leia o arquivo do agente antes de usá-lo para entender seu comportamento
• Forneça contexto máximo sobre o problema ao subagente
• Quando em dúvida entre dois agentes, priorize o de maior impacto
• Após execução, valide as mudanças com testes automatizados ou manuais
• Documente aprendizados para futuras referências

📋 Checklist Pré-Execução

• Problema claramente identificado e categorizado
• Arquivo do agente lido e compreendido
• Backup ou branch de trabalho criado
• Testes disponíveis para validação
• Critérios de sucesso definidos