Benchmark — Linha de Base de Performance e Detecção de Regressão

Quando Usar

• Antes e depois de um PR para medir o impacto na performance
• Configurando linhas de base de performance para um projeto
• Quando usuários relatam "está lento"
• Antes de um lançamento — garanta que você atinja as metas de performance
• Comparando seu stack com alternativas

Como Funciona

Modo 1: Performance da Página

Mede métricas reais do navegador via MCP do navegador:

1. Navigate to each target URL
2. Measure Core Web Vitals:
   - LCP (Largest Contentful Paint) — target < 2.5s
   - CLS (Cumulative Layout Shift) — target < 0.1
   - INP (Interaction to Next Paint) — target < 200ms
   - FCP (First Contentful Paint) — target < 1.8s
   - TTFB (Time to First Byte) — target < 800ms
3. Measure resource sizes:
   - Total page weight (target < 1MB)
   - JS bundle size (target < 200KB gzipped)
   - CSS size
   - Image weight
   - Third-party script weight
4. Count network requests
5. Check for render-blocking resources

Modo 2: Performance da API

Faz benchmark de endpoints de API:

1. Hit each endpoint 100 times
2. Measure: p50, p95, p99 latency
3. Track: response size, status codes
4. Test under load: 10 concurrent requests
5. Compare against SLA targets

Modo 3: Performance do Build

Mede o ciclo de feedback do desenvolvimento:

1. Cold build time
2. Hot reload time (HMR)
3. Test suite duration
4. TypeScript check time
5. Lint time
6. Docker build time

Modo 4: Comparação Antes/Depois

Executa antes e depois de uma mudança para medir o impacto:

/benchmark baseline    # saves current metrics
# ... make changes ...
/benchmark compare     # compares against baseline

Saída:

| Metric | Before | After | Delta | Verdict |
|--------|--------|-------|-------|---------|
| LCP | 1.2s | 1.4s | +200ms | WARNING: WARN |
| Bundle | 180KB | 175KB | -5KB | ✓ BETTER |
| Build | 12s | 14s | +2s | WARNING: WARN |

Saída

Armazena linhas de base em .ecc/benchmarks/ como JSON. Rastreado pelo Git para que a equipe compartilhe as linhas de base.

Integração

• CI: execute /benchmark compare em todo PR
• Combine com /canary-watch para monitoramento pós-deploy
• Combine com /browser-qa para checklist completo pré-lançamento