(OBRIGATÓRIO) Para Codex: Quando o QA deve usar plugins
- Navegador - Controlar o navegador no aplicativo
- Chrome - Controlar o navegador Chrome real do usuário
- Uso do Computador - Controlar aplicativos Windows ou artefatos instalados quando o QA requer interação real com aplicativos fora de um navegador.
- Playwright: usar como braço de automação para ações no navegador, varreduras de controle, capturas de tela, vídeos, rastreamentos e relatórios.
(OBRIGATÓRIO) Para Claude ou outros agentes:
- Use o navegador equivalente, Chrome/sessão, ou capacidade de controle de computador exposta por aquele agente/ambiente de execução ou capacidade similar ao Playwright disponível naquele ambiente.
Revisão de Tempo de Execução de QA com Anvien
Use esta habilidade para verificar o comportamento real em tempo de execução do ponto de vista do usuário. QA é uma função de não correção: inspecionar, executar, registrar, classificar e relatar. Não repare código do produto, testes, especificações, fixtures ou arquivos gerados durante o QA.
Anvien é uma ferramenta de descoberta para QA. Ela ajuda a mapear rotas, superfícies montadas, manipuladores, APIs, lojas, permissões, arquivos fonte e fluxo de dados. Ela não prova que um usuário pode alcançar uma superfície, clicar em um controle, ver o estado correto ou completar um fluxo. A evidência de tempo de execução é a fonte do veredito de QA.
Leis de Ferro
- QA NÃO DEVE corrigir código. Relate apenas bugs, bloqueadores, atritos, lacunas de teste e sugestão de direção de correção.
- O comportamento em tempo de execução é a fonte de verdade do QA. A presença de código, testes, capturas de tela ou saída de gráfico não provam aprovação/reprovação por si só.
- Deve ter Evidência de Captura de Tela.
- Testes verificam comportamentos já corretos. Testes não definem comportamento esperado e não devem legitimar UX errada.
- Testes errados são achados. Um teste verde que codifica comportamento errado não é prova de QA.
- Não pule etapas. Cada etapa de fluxo no escopo importa igualmente.
- Cada superfície, ação, estado, caminho de dados e bloqueador no escopo precisa de um veredito explícito ou marca de fora do escopo.
- Um inventário incompleto ou registro de ações incompleto significa que o QA está incompleto.
- Se um bloqueador impedir a verificação downstream, o escopo downstream é
Bloqueado, não aprovado. - Para QA visível final, abra o site construído real, o tempo de execução ou o artefato de aplicativo gerado da mesma forma que um usuário o abriria, em uma janela de navegador ou aplicativo visível no PC físico do usuário. Execução headless, oculta, apenas fonte, apenas teste ou apenas captura de tela não pode aprovar o QA visível final.
- QA deve ser executado no aplicativo real oficialmente construído (artefato Electron real ou binário de lançamento).
- Cada ação (clicar em botões, inserir dados, alterar estado) deve capturar capturas de tela PNG claras salvas sequencialmente no diretório
screenshots/. - Inspecione visualmente cada imagem capturada / artefato visual para detectar defeitos de UI e comportamentais; nunca confie apenas em asserções em código ou arquivos
.json/.mdde resumo gerados. - Nunca aceite um relatório de QA sem o conjunto de evidências de captura de tela real para cada interação.
Fonte do Comportamento Esperado
Use a primeira autoridade aplicável disponível, nesta ordem:
- Escopo de QA explícito do usuário e instrução de não correção.
- Regras do repositório, como
AGENTS.md. - Plano de execução ativo, plano de QA ou família SPEC.
- Plano de navegador visível quando QA visível final é solicitado ou o plano está no escopo.
- Protocolo de QA desta habilidade.
- Modelo de cobertura, requisitos de inventário e protocolos de controle/estado abaixo.
- Evidência de gráfico do Anvien apenas como suporte de mapeamento.
- Testes automatizados apenas como evidência de verificação.
Se as autoridades entrarem em conflito, declare o conflito e siga a autoridade superior. Nunca use uma expectativa de teste para substituir o comportamento real exigido do produto.
Uso do Anvien em QA
Use o Anvien para evitar perder escopo e para entender o fluxo de dados. Não use o Anvien como substituto para interação em tempo de execução.
Antes do trabalho de gráfico baseado no Anvien, execute:
anvien analyze --force
Escolhas úteis do Anvien:
| Necessidade de QA | Use |
|---|---|
| Encontrar proprietário de rota, página, componente, comportamento ou risco | anvien query "<conceito>" --repo <repo> |
| Encontrar arquivos candidatos para um comportamento | anvien query files "<conceito>" --repo <repo> |
| Inspecionar um arquivo profundamente | anvien file-detail <caminho> --repo <repo> --json |
| Inspecionar manipuladores e consumidores de rota | anvien api route-map [rota] --repo <repo> |
| Inspecionar desvio de forma de resposta contra consumidores | anvien api shape-check [rota] --repo <repo> |
| Inspecionar caminhos de ferramenta/IPC | anvien api tool-map [ferramenta] --repo <repo> |
| Identificar propriedade de fonte para direção de correção sugerida | anvien impact file <caminho> --repo <repo> --direction upstream ou anvien impact symbol "<símbolo>" --repo <repo> --direction upstream |
| Auditar evidência de gráfico se o Anvien parecer desatualizado ou incompleto | anvien graph-health summary --repo <repo> --json |
Registre a evidência do Anvien como evidência de mapeamento de escopo:
- candidatos de rota/página
- candidatos de ponto de entrada montado
- candidatos de ação/manipulador/API
- candidatos de fonte de dados/loja/API/DB
- candidatos de portão de permissão/contexto
- arquivos fonte prováveis para direção de correção sugerida
Não marque nada como aprovado porque o Anvien encontrou. Aprovação/reprovação requer evidência de tempo de execução.
Fluxo de Trabalho Central
- Pré-voo → construir, ambiente de execução, navegador (→ leia
references/runtime-and-build-rules.md) - Inventário → superfícies, controles, estados (→ leia
references/coverage-model.md) - Automação → capturas de tela, varredura de controle (→ leia
references/automation-and-evidence-capture.md) - Fluxo de dados → rastrear fonte de verdade (→ leia
references/data-flow-and-source-of-truth.md) - Localização → se i18n no escopo (→ leia
references/i18n-and-locale.md) - Evidência → coletar, classificar bloqueadores (→ leia
references/evidence-and-blockers.md) - Relatório → achados, veredito, passagem de bastão (→ leia
references/reporting.md)
Árvore de Decisão Rápida
- Preparando construir, ambiente de execução ou navegador? →
references/runtime-and-build-rules.md - Executando varredura de controle ou capturando capturas de tela? →
references/automation-and-evidence-capture.md - Construindo inventário ou verificando matriz de estados? →
references/coverage-model.md - Rastreando fluxo de dados ou leitura de retorno do DB? →
references/data-flow-and-source-of-truth.md - Escopo inclui i18n / localização? →
references/i18n-and-locale.md - Registrando evidência ou lidando com bloqueadores? →
references/evidence-and-blockers.md - Escrevendo relatório ou classificando achados? →
references/reporting.md
Bandeiras Vermelhas
Pare, relate ou reescopo se:
- QA começar a corrigir código.
- QA usar Anvien, código fonte ou testes como prova de aprovação/reprovação.
- QA executar apenas navegador headless/oculto para QA visível final.
- QA pular inventário.
- QA pular uma etapa em um fluxo no escopo.
- QA clicar apenas no caminho feliz.
- QA ignorar estados desabilitados, sem operação, rejeitados, vazios, de erro, obsoletos ou bloqueados.
- QA usar dados falsos de aplicativo/comerciais como se fossem estado de produção real.
- QA ignorar leitura de retorno do DB/fonte para comportamento baseado em DB.
- QA ignorar alterações de localização/sessão/permissão quando no escopo.
- QA relatar escopo downstream como aprovado após um bloqueador upstream.
Índice de Referência
| Necessidade | Arquivo |
|---|---|
| Construir, ambiente de execução, regras de navegador/aplicativo visível | references/runtime-and-build-rules.md |
| Captura de captura de tela, varredura de controle | references/automation-and-evidence-capture.md |
| Inventário, veredito, etapas de fluxo, matriz de estados | references/coverage-model.md |
| Rastreamento de dados, DB, fonte de verdade | references/data-flow-and-source-of-truth.md |
| Escopo i18n / localização | references/i18n-and-locale.md |
| Fontes de evidência, testes, propagação de bloqueador | references/evidence-and-blockers.md |
| Classificação de achados, modelo de relatório, passagem de bastão | references/reporting.md |