name: tao-performance-audit description: "Metodologia de análise de performance com técnicas de profiling, identificação de gargalos e padrões de otimização. Use ao auditar performance, otimizar código lento ou planejar capacidade." user-invocable: false
TAO Auditoria de Performance
Quando usar
Use ao investigar endpoints lentos, alto uso de memória ou planejamento de capacidade.
Protocolo de Auditoria
1. MEDIR — números de baseline (não adivinhe)
2. IDENTIFICAR — encontre o gargalo (não o sintoma)
3. OTIMIZAR — corrija o gargalo (apenas ele)
4. VERIFICAR — meça novamente (prove a melhoria)
Padrões Comuns de Gargalo
Banco de Dados
- Queries N+1 — loop buscando registros relacionados um por um → Fix: JOIN ou eager loading
- Full table scan — índice faltando na cláusula WHERE → Fix: adicionar índice, verificar EXPLAIN
- Overfetching — SELECT * quando só precisa de 2 colunas → Fix: selecionar apenas colunas necessárias
- Esgotamento de conexões — sem pool ou pool muito pequeno → Fix: connection pooling com limites adequados
Aplicação
- I/O síncrono bloqueante — esperando HTTP/DB na thread principal → Fix: async/await, filas de workers
- Memory leaks — caches sem limite, conexões não fechadas → Fix: caches com TTL, cleanup adequado
- Computação desnecessária — recalculando a cada request → Fix: caching (Redis, in-memory), memoização
- Payload grande — enviando 1MB JSON quando cliente precisa de 10 campos → Fix: seleção de campos, paginação, compressão
Frontend
- Tamanho do bundle — importando biblioteca inteira para uma função → Fix: tree-shaking, imports dinâmicos
- Render bloqueante — scripts síncronos grandes → Fix: async/defer, code splitting
Regras de Otimização
- Não adivinhe, meça — profile antes de otimizar
- Otimize o gargalo — speedup 10x no não-gargalo = 0% melhoria
- Simples primeiro — caching, indexação, batching antes de redesenho
- Defina metas — "resposta abaixo de 200ms" não "faça mais rápido"
- Benchmark antes e depois — prove a melhoria com números
Formato de Saída
## Auditoria de Performance — [escopo]
**Data:** AAAA-MM-DD
### Baseline
- [métrica]: [valor atual]
### Análise de Gargalos
| # | Local | Problema | Impacto | Correção |
|---|-------|----------|---------|----------|
| 1 | ... | ... | ... | ... |
### Após Otimização
- [métrica]: [novo valor] (XX% melhoria)