---
name: diagnosticar-saude-deploy
description: >
  Diagnóstico de saúde de deploy e infraestrutura: containers, variáveis
  de ambiente, healthchecks, logs e estado dos serviços.
scope: local
---

# Skill: Diagnosticar Saúde de Deploy

## Objetivo

Avaliar o estado de saúde da infraestrutura e pipelines de deploy antes de aplicar mudanças.

## Etapas

### 1. Verificar Estado dos Containers

```sh
# Listar containers ativos
docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

# Verificar logs recentes de erro
docker logs --tail 50 <container> 2>&1 | grep -i "error\|fatal\|exception\|fail"

# Verificar uso de recursos
docker stats --no-stream
```

### 2. Verificar Variáveis de Ambiente

```sh
# Listar variáveis esperadas (schemas Zod de ambiente)
rg "z\.Ambiente\|process\.env\." --include='*.ts' <modulo>-back/src/ -n

# Verificar se há variáveis sem default ou validação
rg "process\.env\." --include='*.ts' <modulo>-back/src/ -n | grep -v "z\.\|zod\|Ambiente"
```

### 3. Verificar Healthchecks

```sh
# Verificar endpoints de health
rg "health\|alive\|ready" --include='*.ts' <modulo>-back/src/ -n

# Verificar healthcheck no Docker
rg "HEALTHCHECK" Dockerfile* docker-compose* -n
```

### 4. Verificar Build

```sh
# Testar build completo
pnpm build 2>&1 | tail -20

# Verificar migrations pendentes
rg "migration\|migrate" --include='*.ts' <modulo>-migracao/src/ -l
```

### 5. Gerar Relatório

```markdown
# Diagnóstico de Deploy — [nome do módulo]

## Resumo
- **Containers:** N ativos / N esperados
- **Healthchecks:** N configurados
- **Variáveis de ambiente:** N validadas / N sem validação
- **Build:** ✅ OK | ❌ Falha

## Problemas Detectados

### 🔴 Crítico
| Área | Problema | Impacto | Ação |
|------|----------|---------|------|

### 🟡 Moderado
| Área | Problema | Impacto | Ação |
|------|----------|---------|------|

## Plano de Ação
1. ...
```

## Referências

- Rule: `global/rules/diagnostico-antes-correcao`
- Skill: `global/skills/diagnosticar-antes-corrigir/SKILL`