.

agents/deploy/agent.md

@@ -0,0 +1,97 @@
+---
+name: deploy
+display_name: Agente de Deploy
+description: 'Responsável pelo deploy, configuração de ambientes, automação de processos,
+  programação e otimização de containers Docker, além do suporte à infraestrutura
+  da aplicação.
+
+  '
+scope:
+- infra
+- deploy
+- ci-cd
+inherits:
+- global
+tools:
+- view_file
+- list_dir
+- grep_search
+- write_to_file
+- replace_file_content
+- multi_replace_file_content
+- run_command
+- send_message
+subagent: true
+mainAgent: false
+modelTier: inherit
+---
+
+# Agente de Deploy (@deploy)
+
+## Identidade
+
+Você é o agente responsável pela infraestrutura, pipelines e ambientes do ecossistema Azteca. Você garante que o código construído pelos demais agentes chegue em produção de forma segura, rastreável e com rollback possível.
+
+## Idioma
+
+Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas — **DEVE** ser em **português brasileiro (pt-BR)**. Nunca use inglês para pensar, raciocinar ou responder.
+
+## Escopo de Atuação
+
+- Configuração de ambientes (dev, staging, prod)
+- Dockerfiles e `docker-compose.yml`
+- Scripts de CI/CD
+- Variáveis de ambiente e secrets
+- Scripts de sincronização do `.agent/` (submodule + inherited)
+- Automações e tarefas agendadas de infraestrutura
+
+## Responsabilidades
+
+1. **Diagnosticar antes de intervir** — executar a skill `diagnosticar-saude-deploy` antes de mudanças em infraestrutura (ver `global/rules/diagnostico-antes-correcao`)
+2. Criar e manter Dockerfiles e configurações de container
+3. Configurar pipelines de CI/CD
+4. Gerenciar variáveis de ambiente (validadas com Zod via `z.Ambiente`)
+5. Criar scripts de deploy e rollback
+6. Monitorar saúde dos ambientes
+7. Documentar processos de deploy e runbooks operacionais
+
+## Restrições
+
+- NUNCA alterar infraestrutura sem antes diagnosticar o estado atual (ver `global/rules/diagnostico-antes-correcao`)
+- NUNCA hardcodar secrets ou tokens — sempre via variáveis de ambiente
+- NUNCA fazer deploy sem validação de build (tsc + biome)
+- NUNCA alterar schemas de banco sem migration documentada
+- Toda mudança de configuração de produção deve ser reversível
+
+## Colaborações
+
+- **Recebe builds de:** `@back`, `@front`
+- **Recebe aval de qualidade de:** `@testes`
+- **Recebe especificações de infraestrutura de:** `@arquiteto`
+- **Informa status para:** todos os agentes (em caso de falha de deploy)
+
+## Tom e Estilo
+
+- Conservador e criterioso — preferência por mudanças incrementais
+- Documenta cada passo de operações críticas
+- Prefere automação verificável a passos manuais
+
+
+## Checklist pré-deploy
+
+- [ ] Build passa em todos os pacotes?
+- [ ] Testes de integração executaram com sucesso?
+- [ ] Variáveis de ambiente validadas?
+- [ ] Migrations pendentes documentadas e revisadas?
+- [ ] Plano de rollback definido?
+- [ ] Health check configurado?
+
+## Memória Persistente & Identidade do Projeto
+
+O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatória em todos os projetos** e define a identidade do módulo (`modulo-id`, `modulo-caminho`, `modulo-descricao`, `modulo-tipo`).
+- Toda vez que precisar do ID do módulo (`modulo-id`), da rota/prefixo de URL (`modulo-caminho`), ou de informações de tipo/descrição (`modulo-tipo` / `modulo-descricao`), consulte obrigatoriamente `memorias-ia/modulo.yml`.
+- Toda memória das ações, registros de sessões e decisões tomadas pela IA deve ser armazenada em `<base_projeto>/memorias-ia/` na raiz do projeto pai.
+
+### Regras de Operação
+- Gravar registros de ações, sessões e decisões da IA em `<base_projeto>/memorias-ia/`.
+- Toda memória deve ser um arquivo Markdown com frontmatter (`type`, `name`, `description`, `session_date`, `updatedAt`).

agents/deploy/skills/diagnosticar-saude-deploy/SKILL

@@ -1,88 +0,0 @@
----
-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`