diff --git a/global/doutrina_agentes.md b/global/doutrina_agentes.md index b123ce8..fda62b5 100644 --- a/global/doutrina_agentes.md +++ b/global/doutrina_agentes.md @@ -81,3 +81,16 @@ Os seguintes diretórios dentro de `/home/deploy/stack/` contêm contêineres de > [!WARNING] > Quaisquer pastas como `/home/deploy/stack/traefik/`, `/home/deploy/stack/portainer/` ou `/home/deploy/stack/soc/` que sejam encontradas na **VPS 4** são duplicatas inativas e obsoletas e **devem ser deletadas** na limpeza dos agentes. + +--- + +## 🚀 Protocolo de Acesso a Contexto e Instruções (Prioridade de Memória Injetada) + +Para evitar vazamentos de credenciais no disco e garantir imunidade absoluta contra dados desatualizados locais, os agentes devem respeitar a seguinte ordem de prioridade de sincronização ao inicializar: + +1. 🚀 **Injeção em Memória RAM (API REST do Gitea - PRIORITÁRIO MÁXIMO)**: + Os agentes de IA devem prioritariamente ler as instruções mestre chamando a API de Conteúdos do Gitea usando Basic Auth. O conteúdo recuperado é decodificado base64 e mantido estritamente na memória volátil RAM da máquina durante a execução, sem tocar o disco da VPS. +2. 📁 **Arquivos do Disco Local (Filesystem - CONTINGÊNCIA)**: + Caso a API do Gitea esteja temporariamente indisponível, a IA pode recorrer à leitura dos arquivos locais localizados em `/home/deploy/instrucoes/` como contingência secundária. +3. 🔐 **Transporte Remoto e Escrita (Chaves SSH - ESTÁVEL)**: + Para operações de sincronização, deploys ou pushes do Git, os agentes devem usar exclusivamente a chave SSH do usuário `deploy` (`~/.ssh/id_ed25519`), prevenindo qualquer exposição de chaves privadas em logs ou variáveis de ambiente. diff --git a/global/protocolo_agentes.md b/global/protocolo_agentes.md index e7e885c..0a13582 100644 --- a/global/protocolo_agentes.md +++ b/global/protocolo_agentes.md @@ -40,13 +40,20 @@ graph TD ### 🔍 Passo 1: Autocognição e Sincronização (Onde estou?) Toda IA, ao iniciar sua execução, deve identificar em qual máquina física ou container está rodando (ex: `hostname` ou IP da VPN `10.99.0.x`). -**IMEDIATAMENTE APÓS**, o agente DEVE OBRIGATORIAMENTE executar um `git pull` no diretório de instruções (`/home/deploy/instrucoes/`) e **verificar a versão ativa da Doutrina Swarm registrada no Gitea Wiki** (ex: buscando a versão `v1.x.x` ativa indicada na página `Home.md`). +**IMEDIATAMENTE APÓS**, o agente DEVE OBRIGATORIAMENTE sincronizar e carregar seu contexto seguindo a **Relação de Prioridade de Acesso a Instruções**: + +1. 🚀 **[PRIORIDADE MÁXIMA] Injeção Direta em Memória (API REST Gitea)**: + A IA deve prioritariamente requisitar suas instruções e a Doutrina atualizada via API REST do Gitea, mantendo todo o conteúdo estritamente na memória RAM da execução. Isso impede o vazamento de chaves e garante que o agente nunca trabalhe com instruções locais alteradas ou desatualizadas no disco. +2. 📁 **[FALLBACK 1] Disco Local (Filesystem)**: + Caso o Gitea esteja fora do ar ou inacessível, o agente deve ler o diretório local `/home/deploy/instrucoes/` (após efetuar um `git pull` local) como contingência temporária. +3. 🔐 **[TRANSPORTE E DEPLOY] Autenticação via Chaves SSH**: + Para qualquer operação de escrita, clonagem ou atualização remota de repositórios, a IA deve utilizar a chave SSH privada do usuário `deploy` (`~/.ssh/id_ed25519`), eliminando o uso de senhas ou chaves em texto plano. > [!IMPORTANT] > **Versionamento de Wiki Obrigatório**: > Trabalhar com documentação local desatualizada ou desalinhada com a versão da Wiki é um risco crítico de SecOps. A verificação do versionamento garante que o agente siga rigorosamente as diretrizes, firewalls, logs e políticas da release atualizada do Swarm. -* *Exemplo:* "Identificado que estou na **VPS 3**. Realizado `git pull` em `/instrucoes/` e verificado alinhamento com a **Doutrina Swarm v1.0.3** na Wiki para garantir contexto atualizado." +* *Exemplo:* "Identificado que estou na **VPS 3**. Contexto carregado prioritariamente via **Injeção em Memória (API REST)** e alinhado com a **Doutrina Swarm v1.0.4** na Wiki." ### 📖 Passo 2: Leitura do Histórico da Issue Antes de fazer qualquer alteração no código ou nos servidores, o agente deve ler a Issue no Gitea de baixo para cima, analisando o histórico de comentários de outros agentes para entender o que já foi feito e onde o processo parou.