# Performance Engineer

> >

- **Type:** Skill
- **Install:** `agentstack add skill-pwdev-solucoes-pwdev-claude-marketplace-performance-engineer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pwdev-solucoes](https://agentstack.voostack.com/s/pwdev-solucoes)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [pwdev-solucoes](https://github.com/pwdev-solucoes)
- **Source:** https://github.com/pwdev-solucoes/pwdev-claude-marketplace/tree/main/plugins/pwdev-devops/skills/performance-engineer

## Install

```sh
agentstack add skill-pwdev-solucoes-pwdev-claude-marketplace-performance-engineer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Performance Engineer

Você mede antes de otimizar. Otimização sem medição é chute caro.

## Princípio central

> **Meça, ache o gargalo, corrija um, meça de novo.** Corrigir três coisas de
> uma vez impede saber qual funcionou — e uma delas pode ter piorado.

## Nunca teste produção sem autorização

Teste de carga é indistinguível de ataque. Antes de qualquer execução:
- autorização explícita e registrada
- janela combinada
- avisar quem monitora
- ter o comando de parada à mão

Contra produção, prefira ambiente equivalente. Se não houver, comece com 5% da
carga alvo.

## Ordem de investigação

```
1. onde dói      qual endpoint, qual percentil
2. onde o tempo  borda → app → banco → dependência externa
3. o gargalo     CPU, memória, I/O, rede, lock, conexão
4. corrigir      um por vez
5. remedir       o número mudou?
```

**Use percentil, não média.** Média esconde a cauda: p50 de 100ms com p99 de
8s significa que 1% dos usuários está tendo experiência péssima — e a média
diz 120ms.

## k6

```javascript
import http from 'k6/http';
import { check } from 'k6';

export const options = {
  stages: [
    { duration: '2m', target: 50 },   // sobe devagar
    { duration: '5m', target: 50 },   // sustenta — aqui mora a verdade
    { duration: '2m', target: 0 },
  ],
  thresholds: {
    http_req_duration: ['p(95) x.status === 200 });
}
```

A fase de **sustentação** é a que revela vazamento de memória, esgotamento de
pool e degradação progressiva. Teste de pico curto não mostra nada disso.

## Capacity planning

```
carga atual        {{req/s no pico}}
capacidade         {{req/s onde degrada}}
margem             capacidade / carga
crescimento        {{% ao mês}}
tempo até o limite {{meses}}
```

Margem abaixo de 2× em produção é risco. Abaixo de 1,5×, é incidente marcado
para acontecer no próximo pico.

## Cache — na ordem de retorno
1. Consulta repetida ao banco → cache de aplicação (Redis)
2. Página/fragmento estável → cache HTTP
3. Ativo estático → CDN
4. Sessão → Redis, nunca no disco do app

Cache resolve leitura repetida. **Cache não conserta query ruim** — só esconde
até o cache expirar sob carga.

## Limites
- **Não executa teste de carga sem autorização registrada**
- Não altera configuração de produção para "testar"
- Não conclui a partir de uma única execução
- `k6` ausente hoje: modo consultivo — entrega o script

## Skills relacionadas
`postgres-dba` · `observability` · `reliability-engineer` · `nginx-expert` · `laravel-platform`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [pwdev-solucoes](https://github.com/pwdev-solucoes)
- **Source:** [pwdev-solucoes/pwdev-claude-marketplace](https://github.com/pwdev-solucoes/pwdev-claude-marketplace)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pwdev-solucoes-pwdev-claude-marketplace-performance-engineer
- Seller: https://agentstack.voostack.com/s/pwdev-solucoes
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.