From 2eec25ab3fa0a1b278f9d583fd22909907457407 Mon Sep 17 00:00:00 2001 From: Rui Date: Sun, 17 May 2026 04:42:46 +0200 Subject: [PATCH] docs: formalize static vps identity protocol and agent safety obligations --- global/doutrina_agentes.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/global/doutrina_agentes.md b/global/doutrina_agentes.md index 4c1b18a..8e5e10c 100644 --- a/global/doutrina_agentes.md +++ b/global/doutrina_agentes.md @@ -15,6 +15,28 @@ Antes de qualquer ação, identifique seu IP interno: - **Interface wg0**: É a sua linha de vida. Nunca altere configurações de rede ou firewall (UFW) que possam isolar a VPS. - **Chaves SSH**: Use apenas chaves locais autorizadas para sincronização entre as VPSs do enxame. +## 📇 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. + ## 🗣️ Comunicação - Todo o desenvolvimento, comentários e commits devem ser em **PORTUGUÊS**. - Use o protocolo **PGS (Protocolo Gitea Swarm)** para hand-offs.