Esquadrão QA
Um esquadrão de agentes de IA que testa o seu sistema e mostra o teste acontecendo numa cena 3D.
Funciona no Claude Code (app desktop ou terminal), em sistemas que rodam no seu computador ou em homologação.
Criado por Dimitre Souza · Otimiza Aí
O que você precisa
- Claude Code instalado, com plano pago. No chat comum do claude.ai não funciona.
- O seu sistema rodando em
localhost ou em um ambiente de homologação.
- Node.js instalado (usado pela cena ao vivo). Sem ele, o teste roda, mas sem a cena.
Instalar
No Claude Code, dentro da pasta do seu projeto:
/plugin marketplace add dimitresouza12/esquadrao-qa
/plugin install esquadrao-qa@esquadrao-qa
Rodar
/esquadrao-qa:testar
Ele pergunta o endereço do sistema e o modo, mostra a lista de agentes que vai usar e só começa depois da sua confirmação.
Depois imprime um endereço local (http://localhost:4777). Abra no navegador para ver os agentes trabalhando.
Modos
| Modo | Agentes | Quando usar |
|---|
| Ultraleve | 2: api-seguranca, regras-negocio | Primeiríssima checagem, ou plano com pouco limite sobrando |
| Leve | 5: api-seguranca, login-sessao, fluxo-usuario, regras-negocio, fuzz-api | Rodada normal |
| Completo | Até 22, conforme o que o seu sistema tem | Antes de um lançamento ou depois de uma mudança grande |
O catálogo completo, com o que cada agente testa, está em docs/catalogo-de-agentes.md.
Sobre o custo de uso
Cada agente é um subagente do Claude Code, e isso consome uma fatia real do limite do seu plano — não tem como cercar isso num teto exato, porque depende do seu plano e do que você já gastou na janela. O que a skill faz para pesar menos:
- Agentes de checagem mais mecânica (fuzz, formulários, tempo/fuso, e-mails, acessibilidade etc.) rodam num modelo mais leve (Haiku); os que pedem julgamento mais fino (segurança de API, permissões, regras de negócio) ficam no Sonnet.
- Cada agente tem um teto de turnos e instrução para ser direto: poucos casos de teste bem escolhidos, relatório curto.
- Os agentes rodam em lotes de 3, não todos de uma vez.
- Se o limite acabar no meio do teste, rode
/esquadrao-qa:testar de novo: ele reconhece o que já rodou e continua de onde parou, sem pagar de novo pelos agentes concluídos.
Comece pelo ultraleve ou pelo leve antes do completo.
O que ele nunca faz
- Testa só em
localhost ou homologação. Se detectar produção, para e pergunta.
- Não usa credenciais de produção, não faz deploy, não faz push e não apaga dados reais.
- Não edita o código do projeto. Tudo fica em
.esquadrao/.
- Cria dados de teste com o prefixo
QA e só apaga com a sua confirmação.
- Pede permissão antes de instalar qualquer ferramenta.
Como funciona
- Um agente de reconhecimento lê o projeto e gera o mapa do sistema.
- O mapa define quais agentes entram. Cada agente recebe um plano próprio.
- Os agentes rodam em lotes e reportam o andamento em
.esquadrao/ao-vivo/.
- Um servidor local (só em 127.0.0.1) entrega esse andamento à cena 3D.
- No fim sai o
.esquadrao/relatorio/RESUMO.md, com a nota de risco estimada e os achados por gravidade.
Cada achado é marcado como confirmado (reproduzido, com evidência) ou suspeita.
A nota é um termômetro, não uma certificação. O formato dos arquivos está em docs/formato-ao-vivo.md.
Experimente com segurança
exemplos/alvo-demo é um sistema minúsculo e propositalmente vulnerável:
node exemplos/alvo-demo/server.mjs
Depois rode /esquadrao-qa:testar apontando para http://localhost:3999.
Limites
- Só sistemas web e APIs. Aplicativos nativos ficam de fora.
- Itens que só aparecem fora do localhost (HTTPS, cookie
Secure, limite por IP real) não são cobertos.
- Os agentes erram. Revise os achados antes de agir.
Modo gravação (para fazer vídeos)
Na página da demonstração, acrescentar #gravar (horizontal) ou #gravar-vertical (Reels e Stories) ao endereço da página abre só a cena em tela cheia, começando do zero. Esc ou o botão que aparece no canto sai do modo.
Para desenvolver
node scripts/gerar-agentes.mjs # gera plugin/agents/*.md a partir da tabela
node scripts/build.mjs # gera site/dist (Vercel) e copia a cena para o plugin
claude plugin validate .
