Test E2E Playwright Analyzer

Skill para análise de qualidade de testes E2E com Playwright, focada em manutenibilidade, confiabilidade e resiliência de longo prazo.

Purpose

Analisar testes E2E Playwright contra best practices modernas, identificando anti-padrões que comprometem a manutenibilidade e a confiabilidade da suíte. Calcular score quantitativo e fornecer recomendações acionáveis.

When to Use

Invocar esta skill quando:

• Auditar qualidade de testes E2E Playwright existentes
• Revisar code review de PRs com testes Playwright
• Diagnosticar problemas de manutenibilidade em suítes de testes
• Validar aderência a padrões arquiteturais de automação
• Preparar métricas de saúde de testes E2E

Sinais de Teste Playwright

Um teste é reconhecido como Playwright E2E quando apresenta:

• Importa de @playwright/test
• Usa page.locator(), getByRole(), getByText(), getByLabel()
• Extende PageObject ou usa test.extend()
• Usa expect(page).toHaveURL(), waitForLoadState(), waitForResponse()

Workflow de Análise

1. Identificação e Leitura Skim-First

Antes de ler código completo, aplicar token economy:

• Ler apenas imports e assinaturas de teste
• Identificar camada e tipo (web, electron, mobile)
• Verificar presença de fixtures vs hooks tradicionais

2. Checklist por Categoria

Aplicar checklists abaixo em ordem de severidade. Documentar violações com ID acadêmico, linha e mensagem.

Arquitetura e Camadas

Locadores e Seleção

Sincronização e Esperas

Isolamento e Estado

Electron Específico (quando aplicável)

3. Taxonomia de Test Smells

CRITICAL (-2 pontos cada)

HIGH (-1 ponto cada)

MEDIUM (-0.5 ponto cada)

4. Cálculo de Score

Fórmula por Arquivo

Score do arquivo = max(0, 10 - soma_penalidades)

Ponderação por Categoria (score agregado)

Score Final = 0.4*Locatores + 0.3*Sincronização + 0.2*Arquitetura + 0.1*Isolamento

Onde cada categoria é calculada individualmente usando a mesma fórmula de penalidades.

Classificação de Saúde

• 8.0 - 10.0: Excelente - Suíte saudável, follow best practices
• 6.0 - 7.9: Bom - Algumas melhorias necessárias
• 4.0 - 5.9: Regular - Vários anti-padrões, refatoração recomendada
• 2.0 - 3.9: Ruim - Críticos violados, atenção urgente
• 0.0 - 1.9: Crítico - Suíte em risco alto de manutenibilidade

5. Output Format

Retornar relatório estruturado em JSON:

{
  "summary": {
    "total_files": 10,
    "overall_score": 7.2,
    "health_level": "Bom",
    "critical_issues": 5,
    "high_issues": 12,
    "medium_issues": 8
  },
  "files": [
    {
      "path": "tests/e2e/login.spec.ts",
      "layer": "E2E",
      "score": 8.5,
      "category_scores": {
        "locators": 9.0,
        "synchronization": 8.0,
        "architecture": 9.0,
        "isolation": 8.0
      },
      "issues": [
        {
          "id": "PW-LOC-04",
          "severity": "MEDIUM",
          "line": 15,
          "msg": "getByTestId usado quando getByRole seria possível",
          "code": "page.getByTestId('submit-btn')"
        }
      ],
      "smells": ["PW-MED-02"],
      "recommendation": "Substituir getByTestId por getByRole('button', { name: 'Entrar' })"
    }
  ],
  "aggregate_issues": {
    "PW-LOC-05": { "count": 5, "severity": "CRITICAL", "description": "Seletores CSS frágeis" },
    "PW-SYNC-02": { "count": 3, "severity": "CRITICAL", "description": "Esperas fixas" }
  }
}

Anti-padrões: Certo vs. Errado

Referência rápida para análise:

Referências Adicionais

Para análise profunda de arquitetura ou casos específicos, consultar:

• references/playwright-best-practices.md - Guia completo de práticas recomendadas
• references/electron-automation.md - Específico para aplicações Electron