Proposta de agente

Agente Q&A HotéisRIO

Uma operação contínua para testar apps, registrar bugs com evidência e transformar achados em issues prontas para execução.

Web app testing QA conversacional GitHub Issues Triagem Playwright
Objetivo

O agente será a camada de qualidade dos sistemas HotéisRIO.

Ele navega pelos apps como um usuário real, identifica problemas, captura evidências, descreve passos de reprodução e abre issues bem formadas no GitHub.

Menos bug invisível Fluxos críticos passam por smoke tests e checks visuais recorrentes.
Mais clareza para corrigir Cada problema vira uma issue com contexto, impacto, evidência e reprodução.
Fila pronta para agentes A triagem marca o que pode ser resolvido por agentes e o que exige decisão humana.
O que ele fará

Funções principais

1. Inventariar apps Mapear projetos, URLs, comandos de execução, ambientes, contas de teste e fluxos essenciais.
2. Executar testes reais Abrir páginas, clicar, preencher formulários, testar mobile, verificar console e rede.
3. Capturar evidências Salvar screenshots, traces, logs de erro, dados de entrada e resultado observado.
4. Abrir issues acionáveis Criar issues no GitHub com comportamento esperado, comportamento real e passos de reprodução.
5. Triar e priorizar Classificar severidade, estado, bloqueios, dono sugerido e prontidão para agente.
6. Validar correções Reexecutar o fluxo depois do fix e fechar o ciclo com teste de regressão.
Arquitetura de equipe

Três agentes, três responsabilidades.

Agente Responsabilidade Melhor uso
Anthropic Web App Testing Executar testes visuais e funcionais no navegador, com screenshots, console, rede e passos reais. Encontrar bugs nos fluxos de usuário.
Matt Pocock QA/Triage Converter achados em issues duráveis, classificar estado e preparar briefs para agentes. Organizar o backlog no GitHub.
Misto HotéisRIO QA Commander Orquestrar inventário, rodadas de teste, triagem, prioridade e relatório executivo. Rodar a operação de qualidade ponta a ponta.
Skill stack

Equipe de skills do agente

Setup
setup-matt-pocock-skills configura issue tracker, labels, docs de domínio e regras que os agentes vão seguir.
Q&A
qa conduz sessões de reporte de bugs e cria GitHub issues com linguagem de produto.
Triagem
triage move cada issue por estados como needs-triage, needs-info, ready-for-agent e wontfix.
Diagnóstico
diagnose e diagnosing-bugs reproduzem problemas, minimizam cenários e validam hipóteses.
Regressão
tdd cria testes quando o bug precisa virar proteção permanente contra retorno.
Fluxo operacional

Como uma rodada de teste acontece

1 Descobrir Localizar app, comando de execução, URL, usuário de teste e fluxos críticos.
2 Testar Navegar como usuário real em desktop e mobile, com checks de console e rede.
3 Provar Salvar screenshot, trace, entrada usada, resultado real e expectativa.
4 Registrar Abrir issue no GitHub com reprodução, severidade e contexto de domínio.
5 Validar Depois do fix, reexecutar o fluxo e marcar a regressão como protegida.
Escopo inicial

Projetos HotéisRIO que entram na primeira varredura

WordPress / publicação Postagens, dual publish, assets, preview, publicação e validação pública.
Campanhas e email HTML final, teste de envio, segmentação, renderização e pacote de entrega.
CRM / dashboards Importação, filtros, deduplicação, relatórios, exportação e leitura offline.
CONEX HotéisRIO Marketplace, SEO, acesso, navegação e conversão dos fluxos principais.
Campanhas sazonais Dia dos Namorados, páginas de hotéis, slugs, ofertas e emails de confirmação.
Monitores operacionais Coleta, ranking editorial, artefatos de saída e validação dos dados reais.
Critérios de qualidade

O agente não declara sucesso sem evidência.

Critério Como verifica Resultado esperado
Carregamento Abre a URL, espera renderização, verifica erros de console e rede. Página funcional sem erro crítico.
Fluxo crítico Executa passos reais: buscar, cadastrar, publicar, enviar, exportar ou confirmar. Usuário conclui a tarefa sem bloqueio.
Mobile Reexecuta nos tamanhos principais de tela. Sem sobreposição, texto cortado ou ação inacessível.
Dados reais Confere planilhas, HTMLs, WordPress, APIs ou arquivos locais usados pelo app. Sem mock quando a tarefa exige dado real.
Entregáveis

O que será commitado no repo

Playbook de QA Documento com fluxo de execução, severidade, evidências mínimas e padrão de relatório.
Inventário de apps Lista de projetos, URLs, comandos, ambientes, fluxos e credenciais de teste permitidas.
Templates GitHub Issue templates e labels para bug, triage, ready-for-agent, needs-info e wontfix.
Relatórios de rodada Pasta de execuções com resumo, evidências, status e links das issues criadas.
Briefs para agentes Issues quebradas em unidades pequenas, paralelizáveis e verificáveis.
Checklist de regressão Casos que precisam ser reexecutados depois de cada correção.
Modelo de issue

Cada bug nasce pronto para ser corrigido.

O que aconteceu
Descrição curta do comportamento real observado pelo usuário ou pelo teste automatizado.
O esperado
Resultado correto do ponto de vista do negócio, sem citar detalhes frágeis de implementação.
Reprodução
Passos numerados, dados usados, ambiente, viewport e condição em que o erro apareceu.
Evidência
Screenshot, trace, console, network log, URL, arquivo ou payload suficiente para validar o problema.
Próximo estado
needs-info, ready-for-agent, ready-for-human ou wontfix, com justificativa curta.
Roadmap

Primeiros 7 passos

1 Escolher repo Definir onde o agente e os documentos oficiais vão morar.
2 Configurar skills Rodar setup Matt Pocock: tracker, labels e docs de domínio.
3 Mapear apps Registrar projetos HotéisRIO, comandos, URLs e fluxos críticos.
4 Rodada piloto Testar 1 ou 2 apps com Playwright e evidência visual.
5 Abrir issues Transformar achados reais em backlog GitHub priorizado.
Decisão recomendada

Começar pelo agente misto.

Ele combina execução real de browser com triagem GitHub. Depois que o fluxo estiver maduro, separamos Anthropic Testing e Matt Pocock Triage como agentes independentes.

Mais rápido para operar Uma única entrada para pedir: teste este app e abra as issues.
Responsabilidades internas claras Um papel testa; outro escreve e tria. O comandante coordena.
Evolui sem recomeçar A estrutura já nasce pronta para virar equipe de agentes separados.