commit 7cd8dcb91dd2874cb60f027319b356f15fc7c598 Author: ruicesar Date: Sun May 17 08:11:37 2026 +0200 docs: initialize wiki with Home and v1.0.0 guidelines diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..a8c0ef8 --- /dev/null +++ b/Home.md @@ -0,0 +1,11 @@ +# 🧠 Central de Inteligência - Wiki Swarm + +Bem-vindo à Wiki central de diretrizes e doutrinas do enxame de agentes de IA. + +Aqui gerenciamos o versionamento oficial das nossas instruções de infraestrutura: + +## 🗂️ Versionamento das Diretrizes: +* [📖 Doutrina Swarm - Versão Inicial v1.0.0](v1.0.0) + +--- +*Para atualizar, crie uma nova página seguindo a nomenclatura de versão (ex: v1.0.1, v1.0.2).* diff --git a/v1.0.0.md b/v1.0.0.md new file mode 100644 index 0000000..8b2ecee --- /dev/null +++ b/v1.0.0.md @@ -0,0 +1,42 @@ +# 🧠 Doutrina Swarm - Versão v1.0.0 (Inicial) + +Esta é a especificação oficial de funcionamento e segurança para todos os agentes autônomos. + +--- + +## 📇 1. Protocolo de Identidade Estática (`~/.vps_identity`) +Para garantir 100% de consciência situacional à prova de falhas sem depender de chamadas de rede externas, cada máquina do enxame possui um arquivo de identidade em `/home/deploy/.vps_identity`. + +### 📄 Estrutura Obrigatória do JSON: +Todo arquivo `.vps_identity` deve conter exatamente a seguinte estrutura: +```json +{ + "vps_id": 4, + "vps_name": "VPS-4-LABORATORIO", + "ip_vpn": "10.99.0.4", + "role": "Desenvolvimento, Builds e Staging", + "danger_level": "BAIXO - Liberdade para testar e recriar" +} +``` + +### 🚨 Obrigações das IAs e Agentes: +1. **Verificação Obrigatória**: Toda execução de script ou agente deve prioritariamente ler e interpretar o arquivo `/home/deploy/.vps_identity` para calibrar o seu escopo de atuação. +2. **Respeito ao Danger Level (Nível de Perigo)**: + - **Nível de Perigo ALTO** (ex: VPS 1, VPS 3): Agentes **NÃO PODEM** rodar comandos experimentais, mutações não homologadas de bancos de dados ou reinstalar dependências críticas sem backups nítidos e aprovação explícita. + - **Nível de Perigo BAIXO** (ex: VPS 4): O agente possui total autonomia para realizar testes, compilar códigos, reinstalar pacotes e reiniciar contêineres Docker de staging. +3. **Resiliência (Fallback)**: Caso o arquivo `.vps_identity` não exista ou esteja ilegível, o agente deve fazer o fallback dinâmico (buscando o IP `10.99.x.x` via `hostname -I`) e assumir o perfil de segurança mais restritivo por padrão. + +--- + +## 📍 2. Identificação de Localização (VPN `10.99.0.x`) +* **10.99.0.1 (VPS 1 - PRODUÇÃO)**: Ambiente CRÍTICO. Rodando Traefik e Nginx. Apenas deploys homologados. Nunca mexa na infraestrutura de rede. +* **10.99.0.3 (VPS 3 - CÉREBRO)**: Onde reside o Gitea, Postgres e DragonflyDB. Proteja os dados. Backups antes de qualquer alteração de schema. +* **10.99.0.4 (VPS 4 - LABORATÓRIO)**: Desenvolvimento e Staging. Liberdade para testar, criar e quebrar containers. +* **10.99.0.5 (VPS 5 - WHATSAPP CRM)**: WhatsApp CRM. + +--- + +## 🗣️ 3. Regras de Comunicação e Handoff +- Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**. +- Use o protocolo **PGS (Protocolo Gitea Swarm)** para transição de tarefas. +- Sempre previna loops ignorando webhooks que contenham a assinatura `🤖` se forem emitidos pelo bot.