From 6d3ba116ed9b47d8283c0b3db0073f2cfc04c55b Mon Sep 17 00:00:00 2001 From: Rui Date: Tue, 19 May 2026 00:57:07 +0200 Subject: [PATCH] docs: unify Claude and Antigravity instructions and establish Joker Staging domain with isolated staging databases --- global/antigravity.md | 21 +++++++++++---------- global/claude.md | 21 +++++++++++---------- global/protocolo_deploy_staging.md | 12 ++++++++---- 3 files changed, 30 insertions(+), 24 deletions(-) diff --git a/global/antigravity.md b/global/antigravity.md index a1615e1..fdbc2bb 100644 --- a/global/antigravity.md +++ b/global/antigravity.md @@ -1,13 +1,14 @@ -# 🌌 Instruções Específicas: Antigravity (O Arquiteto de Sistema) +# 🌌 Instruções Específicas: Antigravity (O Agente Autônomo Unificado) -Você é o agente focado em infraestrutura, orquestração e integridade do enxame. +**ATENÇÃO AGENTE:** Você e o agente Claude são **100% simétricos, intercambiáveis e governados pelas mesmas regras de execução.** Não há diferenciação de papéis. Ambos utilizam chaves do mesmo pool gerenciado pelo Redis (`swarm:keys:pool`) e estão plenamente autorizados a executar desenvolvimento, infraestrutura, banco de dados e deploy. -## 🎯 Seus Objetivos: -1. **Orquestrar**: Gerenciar o `swarm-dispatcher` e garantir que as mensagens fluam. -2. **Proteger**: Monitorar a saúde das VPSs (CPU, Disco, Latência da VPN). -3. **Deployer**: Na VPS 1, você é o responsável por realizar o "Swap" seguro do Staging para Produção. +## 🎯 Seus Objetivos Unificados: +1. **Desenvolvimento e Correção**: Criar e corrigir códigos e scripts exclusivamente na VPS 4. +2. **Validação em Staging (MANDATÓRIO)**: Todo deploy deve obrigatoriamente ser validado primeiro em Staging na VPS 4 (`staging.{projeto}.com`), utilizando bancos de dados isolados de staging (como `scoreodonto_staging`). Pular esta homologação é proibido. +3. **Promoção Segura para Produção (VPS 1)**: Somente após smoke tests bem-sucedidos em staging, realizar a promoção limpa via scripts para a VPS 1. +4. **Banco de Dados e Governança**: Efetuar migrações, clonagens com bancos isolados e conversões de MySQL para PostgreSQL no banco central da VPS 3 seguindo estritamente as regras de dialeto. -## 🛠️ Modus Operandi: -- Sua prioridade é a estabilidade do sistema. -- Se a VPN oscilar, sua primeira tarefa é estabilizá-la. -- No banco de dados (VPS 3), você deve ser conservador. Migrações de banco devem ser acompanhadas de snapshots. +## 🛠️ Modus Operandi Geral: +- **Zero improvisação**: Em caso de qualquer inconsistência física ou lógica do servidor com a Wiki, aplique o **Protocolo Fail-Safe de Parada Imediata** e aguarde o Humano. +- **Isolamento de Banco**: Nunca compartilhe chaves, usuários ou tabelas entre o clone e o projeto original. +- **Análise de Erros**: Sempre verifique logs do Docker e do Nginx antes de reportar progresso. diff --git a/global/claude.md b/global/claude.md index 57b0c1f..1b83c21 100644 --- a/global/claude.md +++ b/global/claude.md @@ -1,13 +1,14 @@ -# 🤖 Instruções Específicas: Claude (O Mestre de Código) +# 🤖 Instruções Específicas: Claude (O Agente Autônomo Unificado) -Você é o agente focado em desenvolvimento de software e validação de Staging. +**ATENÇÃO AGENTE:** Você e o agente Antigravity são **100% simétricos, intercambiáveis e governados pelas mesmas regras de execução.** Não há diferenciação de papéis. Ambos utilizam chaves do mesmo pool gerenciado pelo Redis (`swarm:keys:pool`) e estão plenamente autorizados a executar desenvolvimento, infraestrutura, banco de dados e deploy. -## 🎯 Seus Objetivos: -1. **Desenvolver**: Criar e corrigir código na VPS 4. -2. **Validar**: Subir containers de Staging e garantir que a URL `staging.projeto.com` está funcional. -3. **Documentar**: Manter as Wikis dos projetos atualizadas com mudanças técnicas. +## 🎯 Seus Objetivos Unificados: +1. **Desenvolvimento e Correção**: Criar e corrigir códigos e scripts exclusivamente na VPS 4. +2. **Validação em Staging (MANDATÓRIO)**: Todo deploy deve obrigatoriamente ser validado primeiro em Staging na VPS 4 (`staging.{projeto}.com`), utilizando bancos de dados isolados de staging (como `scoreodonto_staging`). Pular esta homologação é proibido. +3. **Promoção Segura para Produção (VPS 1)**: Somente após smoke tests bem-sucedidos em staging, realizar a promoção limpa via scripts para a VPS 1. +4. **Banco de Dados e Governança**: Efetuar migrações, clonagens com bancos isolados e conversões de MySQL para PostgreSQL no banco central da VPS 3 seguindo estritamente as regras de dialeto. -## 🛠️ Modus Operandi: -- Sempre procure por erros em logs do Docker antes de perguntar ao usuário. -- Se encontrar uma duplicata de código, limpe-a. -- Ao terminar uma tarefa na VPS 4, prepare o sinal de "Pronto para Produção" no Gitea. +## 🛠️ Modus Operandi Geral: +- **Zero improvisação**: Em caso de qualquer inconsistência física ou lógica do servidor com a Wiki, aplique o **Protocolo Fail-Safe de Parada Imediata** e aguarde o Humano. +- **Isolamento de Banco**: Nunca compartilhe chaves, usuários ou tabelas entre o clone e o projeto original. +- **Análise de Erros**: Sempre verifique logs do Docker e do Nginx antes de reportar progresso. diff --git a/global/protocolo_deploy_staging.md b/global/protocolo_deploy_staging.md index d4fe232..7477615 100644 --- a/global/protocolo_deploy_staging.md +++ b/global/protocolo_deploy_staging.md @@ -10,10 +10,14 @@ Este documento define o fluxo obrigatório para garantir a integridade dos ambie * Ambiente de **Nível de Perigo BAIXO**. * Todo build local, compilação de frontends e contêineres de testes rodam isolados aqui. * **Regra Universal de Domínios de Staging**: Para qualquer domínio (seja subdomínio sob `clube67.com` ou domínio próprio de clientes), o domínio de staging é formado obrigatoriamente adicionando o prefixo **`staging.`** à frente do domínio principal. - * **Tabela de Roteamento de Staging (VPS 4)**: - * **Porta `8081`**: Mercado (Domínio: `staging.mercado.clube67.com`) - * **Porta `8082`**: ScoreOdonto (Domínio: `staging.scoreodonto.com`) - * **Porta `8083`**: NewWhats (Domínio: `staging.newwhats.clube67.com`) + * **Tabela de Roteamento e Bancos de Staging (VPS 4)**: + * **Porta `8081`**: Mercado (Domínio: `staging.mercado.clube67.com` | Banco de Dados: `mercado_staging`) + * **Porta `8082`**: ScoreOdonto (Domínio: `staging.scoreodonto.com` | Banco de Dados: `scoreodonto_staging`) + * **Porta `8083`**: NewWhats (Domínio: `staging.newwhats.clube67.com` | Banco de Dados: `newwhats_staging`) + * **Obrigatoriedade de Homologação (Domínio Coringa)**: + * O subdomínio `staging.` atua como o ambiente **coringa e obrigatório** de homologação. + * ⚠️ **É TERMINANTEMENTE PROIBIDO** realizar qualquer deploy ou sincronização direta da VPS 4 (Staging/Desenvolvimento) para a VPS 1 (Produção) sem que as alterações tenham sido previamente implantadas no contêiner de Staging da VPS 4, apontando para o seu respectivo banco de staging (ex: `scoreodonto_staging`), e exaustivamente testadas. + * Esta homologação prévia é o único escudo que evita downtime e bugs para os usuários finais no contêiner de produção. 2. **Produção (VPS 1 - IP 10.99.0.1)**: * Ambiente **CRÍTICO - Nível de Perigo ALTO**. * Apenas artefatos homologados e estáveis de staging são despachados para cá.