Communitygithub.com

QA de Navegador — Teste Visual Automatizado e Interação

Use esta skill para automatizar testes visuais e verificação de interação de UI por meio de automação de navegador após implantar funcionalidades.

O que é QA de Navegador — Teste Visual Automatizado e Interação?

Esta skill permite que um agente de IA realize testes visuais automatizados e verificação de interação de UI usando automação de navegador (MCP como claude-in-chrome, Playwright ou Puppeteer). Ela é ideal para usar após implantar uma funcionalidade em staging/preview, antes do lançamento ou ao revisar PRs que mexem no frontend. A skill executa quatro fases: teste de fumaça (verificação de erros de console, problemas de rede e Core Web Vitals), teste de interação (navegação, formulários, fluxos de autenticação), regressão visual (capturas de tela em 3 breakpoints, comparação com baselines) e acessibilidade (axe-core, WCAG 2.2 AA, navegação por teclado, leitores de tela). Por segurança, o padrão é somente leitura; jornadas mutantes (checkout, pagamento, exclusão) só são executadas contra staging com aceitação explícita, usando credenciais de teste, nunca de produção. O relatório final indica se o deploy deve ser enviado (SHIP), enviado com correções (SHIP WITH FIXES) ou não enviado (DO NOT SHIP).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/browser-qa

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Browser QA — Teste Visual Automatizado e Interação

Quando Usar

  • Após implantar uma funcionalidade em staging/preview
  • Quando precisar verificar o comportamento da IU em várias páginas
  • Antes do lançamento — confirmar que layouts, formulários e interações realmente funcionam
  • Ao revisar PRs que mexem no código frontend
  • Auditorias de acessibilidade e testes responsivos

Como Funciona

Usa o MCP de automação de navegador (claude-in-chrome, Playwright ou Puppeteer) para interagir com páginas ao vivo como um usuário real.

Segurança primeiro — raio de alcance (executar somente leitura por padrão)

O QA de Navegador usa autenticação real e jornadas reais de usuário, portanto trate o raio de alcance explicitamente. Padrão é somente leitura: nunca execute uma jornada mutante (checkout, pagamento, exclusão, atualização em massa) contra uma URL de produção — exija uma aceitação explícita e uma URL staging/preview. Use credenciais de teste semeadas, nunca logins reais de produção, e remova credenciais/tokens/PII antes de salvar qualquer captura de tela.

Fase 1: Teste de Fumaça

1. Navegue até a URL alvo
2. Verifique erros de console (filtre ruídos: analytics, terceiros)
3. Verifique se não há 4xx/5xx nas requisições de rede
4. Capture tela acima da dobra em viewport desktop + mobile
5. Verifique Core Web Vitals: LCP < 2,5s, CLS < 0,1, INP < 200ms
   (INP substituiu FID em março de 2024; limites conforme web.dev)

Fase 2: Teste de Interação

1. Clique em cada link de navegação — verifique se não há links mortos
2. Envie formulários com dados válidos — verifique estado de sucesso
3. Envie formulários com dados inválidos — verifique estado de erro
4. Teste fluxo de autenticação: login → página protegida → logout (apenas credenciais de teste, nunca produção)
5. Teste jornadas críticas de usuário (checkout, onboarding, pesquisa)
   — somente leitura por padrão; exercite jornadas mutantes apenas contra staging
     com aceitação explícita (veja "Segurança primeiro" acima)

Fase 3: Regressão Visual

1. Capture tela de páginas-chave em 3 breakpoints (375px, 768px, 1440px)
2. Compare com capturas de tela de linha de base commitadas
   — sem linha de base ⇒ reporte INCONCLUSIVO, nunca um PASS silencioso
3. Sinalize mudanças de layout > 5px, elementos ausentes, overflow
4. Verifique modo escuro se aplicável

Fase 4: Acessibilidade

1. Execute axe-core ou equivalente em cada página
2. Sinalize violações WCAG 2.2 AA (contraste, rótulos, ordem de foco)
3. Verifique se a navegação por teclado funciona de ponta a ponta
4. Verifique pontos de referência de leitor de tela

Nota: axe-core cobre automaticamente cerca de 30–40% da WCAG. Uma execução limpa é necessária, não suficiente — navegação por teclado, ordem de foco e uma verificação com leitor de tela ainda precisam de verificação manual. Não relate "acessível" apenas com uma verificação automatizada.

Formato de Saída

## Relatório de QA — [URL] — [timestamp]

### Teste de Fumaça
- Erros de console: 0 críticos, 2 avisos (ruído de analytics)
- Rede: todos 200/304, sem falhas
- Core Web Vitals: LCP 1,2s ✓, CLS 0,02 ✓, INP 89ms ✓

### Interações
- [✓] Links de navegação: 12/12 funcionando
- [✗] Formulário de contato: estado de erro ausente para e-mail inválido
- [✓] Fluxo de autenticação: login/logout funcionando

### Visual
- [✗] Seção hero transborda no viewport 375px
- [✓] Modo escuro: todas as páginas consistentes

### Acessibilidade
- 2 violações AA: texto alternativo ausente na imagem hero, contraste baixo nos links do rodapé

### Veredito: ENVIAR COM CORREÇÕES (2 problemas, 0 bloqueadores)
# veredito ∈ ENVIAR / ENVIAR COM CORREÇÕES / NÃO ENVIAR; use INCONCLUSIVO se não houver linha de base visual

Integração

Funciona com qualquer MCP de navegador:

  • Ferramentas mChild__claude-in-chrome__* (preferido — usa seu Chrome real)
  • Playwright via mcp__browserbase__*
  • Scripts Puppeteer diretos

Combine com /canary-watch para monitoramento pós-implantação.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Habilidades Relacionadas