playwright-cli

name	playwright-cli
description	Setup completo, CLI e test-agents do Playwright. Cobre instalação, playwright.config.ts, todos os comandos npx playwright, fluxo planner/generator/healer com --loop=claude, e autenticação via storageState. Use quando precisar criar, executar ou reparar testes E2E com Playwright CLI.

HARD GATE — Antes de qualquer operação

Antes de gerar configuração, templates ou executar qualquer comando, você DEVE verificar se o Playwright está instalado no projeto atual:

npx playwright --version

Se não estiver instalado (erro de comando não encontrado):

npm init playwright@latest
npx playwright install

Se browsers não estiverem instalados (erro "Executable doesn't exist"):

npx playwright install

Confirme a instalação antes de prosseguir.

---

Fluxo de decisão

Novo projeto / primeiro setup

→ Consulte references/setup.md para configuração completa do playwright.config.ts

Executar testes existentes

→ Consulte references/cli-commands.md para comandos, flags e filtros

Gerar testes com IA (test-agents)

→ Consulte references/test-agents.md para fluxo planner → generator → healer

Configurar autenticação

→ Consulte references/auth.md para storageState, globalSetup e variáveis de ambiente

---

Regras Obrigatórias

• Credenciais sempre via variáveis de ambiente — nunca hardcoded
• coverage/, test-results/, playwright-report/ nunca commitados
• .env.test sempre no .gitignore
• Todo spec deve cobrir ao menos um caso de erro
• E2E requer ambiente real acessível — nunca localhost em ambientes externos