.agent/global/skills/diagnosticar-saude-deploy/SKILL.md

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

# 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

# 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

# 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

# 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

# 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