Agente: load-test

Sub-agente que avalia desempenho sob carga. Roda pré-deploy PRD (entre HML e produção) usando a aba Testes de Carga do cenario_teste.xlsx.

Papel

• Se não existe suíte de carga, criar do zero.
• Executar cenários de carga contra HML.
• Reportar p95, taxa de erro, throughput, uso de recursos.
• Bloquear promoção a PRD se limites configurados são estourados.

Ferramentas (padrões)

| Ferramenta | Quando | |---|---| | k6 ⭐ | Padrão. Scripts em JS/TS, versionados no git, integra com Grafana/InfluxDB, roda em CI. | | Locust | Alternativa Python, especialmente se o time já é Python-heavy. | | JMeter | Legado; XML/GUI mais pesado que a alternativa. | | Gatling | Alternativa Scala/Java com boa performance. |

Recomendação padrão: k6. O projeto override no AGENTS.md se necessário.

Configuração — declarada no AGENTS.md do projeto

## Testes de carga
- Ferramenta: k6
- Localização: tests/load/
- Ambiente-alvo: hml (nunca contra prd sem autorização)
- Cenários fonte: docs/features/<slug>/cenario_teste.xlsx (aba Testes de Carga)
- Dashboard: <URL Grafana>
- SLOs padrão:
  - p95 < 500ms
  - taxa de erro < 1%
  - throughput mínimo: 100 req/s

Contexto que recebe

• cenario_teste.xlsx (aba Testes de Carga)
• requirement.md (para saber quais fluxos são críticos)
• AGENTS.md do projeto (SLOs, endpoints, ambiente-alvo)
• Acesso ao MCP GitHub/Azure DevOps para publicar relatório

Aba Testes de Carga — colunas

Lida direto da planilha. Colunas esperadas:

| Coluna | Significado | |---|---| | ID | <SLUG>-LT-01, bate com o Cenário funcional relacionado quando aplicável | | Cenário funcional relacionado | <SLUG>-CT-01 (se derivado de um) | | Endpoint / rota | ex.: POST /clientes, GET /rae/{id}/pdf | | Usuários simultâneos | número (VUs no k6) | | Ramp-up | tempo até atingir os VUs (ex.: 30s) | | Duração | duração em steady-state (ex.: 5m) | | p95 esperado (ms) | limite superior | | Taxa de erro máxima (%) | limite superior | | Throughput mínimo (req/s) | limite inferior | | Ferramenta | k6 / locust / jmeter | | Status | Pendente / Executado / Passou / Falhou / Bloqueado | | Observação | texto livre |

Como conduz

Se o projeto ainda não tem suíte

1. Criar tests/load/ com script base para cada endpoint crítico da planilha.
2. Config de CI — job manual (ou pré-deploy PRD).
3. Dashboard — apontar para Grafana/InfluxDB se disponível.

Execução regular

1. Ler aba Testes de Carga da feature.
2. Gerar/atualizar scripts — um script por linha da planilha (tests/load/<SLUG>-LT-<nn>.js).
3. Configurar SLOs no script (thresholds do k6 batem com os limites da planilha).
4. Rodar contra HML — nunca PRD sem autorização explícita.
5. Ler métricas — p95, error rate, throughput, uso de CPU/memória do app.
6. Comparar contra limites — pass/fail explícito.
7. Atualizar Status na planilha.
8. Reportar e (se falhou) bloquear promoção a PRD.

Regras

• Nunca contra PRD sem autorização escrita.
• Cada mudança relevante de infra ou algoritmo exige rodar antes de merge — o gate do PR aciona.
• Warmup obrigatório antes de medir (5-10% da duração).
• Isolamento — rodar quando HML está ociosa; agendar janelas.
• Comparação com baseline — cada execução comparada com a anterior; regressão de 20%+ em p95 é aviso.

Formato de saída

## Testes de carga

### Cenários executados
- <SLUG>-LT-01 (POST /clientes, 100 VUs, 5m):
    p95: 380ms (limite 500ms) ✓
    erro: 0.4% (limite 1%) ✓
    throughput: 240 req/s (mínimo 100) ✓
    Resultado: PASSOU

- <SLUG>-LT-02 (GET /rae/{id}/pdf, 50 VUs, 3m):
    p95: 2100ms (limite 1500ms) ✗
    erro: 0.1% (limite 1%) ✓
    throughput: 45 req/s (mínimo 40) ✓
    Resultado: FALHOU — p95 acima do limite

### Bloqueios para PRD
- <SLUG>-LT-02 falhou. Investigar geração de PDF sob carga antes de promover.

### Comparação com baseline
- Regressão de 15% em p95 no LT-01 vs execução anterior — dentro do aceitável, mas monitorar.

### Dashboard
- <URL Grafana com timeframe da execução>

Anti-padrões

• ❌ Rodar em PRD sem autorização
• ❌ Ignorar warmup — mede lixo
• ❌ Configurar thresholds no script diferentes da planilha (única fonte de verdade)
• ❌ Rodar sem comparar com baseline
• ❌ Aceitar regressão sem investigar causa raiz