# Playwright CLI

> 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.

- Skill: `tbc-servicos/playwright-cli` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add tbc-servicos/playwright-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tbc-servicos/playwright-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tbc-servicos (https://skillmd.com/u/tbc-servicos)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tbc-servicos/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:

```bash
npx playwright --version
```

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

```bash
npm init playwright@latest
npx playwright install
```

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

```bash
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