Como escrever um bom caso
O texto do caso é o que o agente segue. Quanto mais concreto, menos tentativas (e menos do limite do seu Claude) ele gasta.
O que um bom caso tem
- Um fluxo só. "Login com senha errada" e "login certo" são dois casos, não um.
- Passos na ordem, como uma checklist: digite
/no editor e escolha "Checklist de passos". - Dados concretos: o produto, o texto a digitar, a opção a escolher.
- O que conferir no fim: a mensagem, o valor, a página. Sem isso o teste só prova que nada quebrou no caminho.
- Credenciais por nome, nunca o valor:
@secret:qa_user(digite@para ver as do ambiente). Veja Credenciais.
Ruim
Testar o carrinho.
O agente não sabe o que adicionar, quanto, nem o que deveria acontecer. Ele vai adivinhar, e o teste vai conferir a adivinhação.
Bom
- Entrar com
@secret:qa_usere@secret:qa_password - Buscar "caneca azul" e abrir o primeiro resultado
- Escolher a quantidade 2 e clicar em "Adicionar ao carrinho"
- Abrir o carrinho
- Conferir: 2 unidades de "Caneca azul" e o subtotal com o dobro do preço unitário
Depois de gerar
- O agente explora o site na janela do app e grava o teste em
tests/, espelhando a pasta do caso emcases/. - Leia o teste antes de aceitar na suíte: ele é um arquivo Playwright comum, que roda sem o KraniQA.
- Se o site mudou e o teste quebrou, abra o caso e peça para o agente corrigir no chat.