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

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
+13
View File
@@ -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.