ruicesar/instrucoes_gerais
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: document priority context loading from RAM memory injected via API REST in Doutrina and Protocolo

Browse Source
This commit is contained in:
Rui
2026-05-17 09:51:40 +02:00
parent 9929d2e25b
commit 7e177d8252
2 changed files with 22 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
global/protocolo_agentes.md
+9 -2
View File
@@ -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.