Seu agente captura o dia inteiro.
Falta quem organize.
Você já tem um agente rodando na sua VPS, conversando com você no Telegram e guardando o que aparece. Isso é metade de um segundo cérebro. A outra metade é o Guardião: um agente no seu computador que lê o que foi capturado, entende, e coloca cada coisa no lugar certo — com você olhando.
Este guia monta essa segunda ponta e liga as duas. No fim, o que você falar no Telegram chega ao seu computador, vira memória organizada e volta para o agente melhor do que saiu.
Duas pontas, uma memória só
Hoje o seu cérebro tem uma ponta só: o agente na VPS escreve, e ele mesmo decide onde. Funcionou para começar — era mais importante alimentar o cérebro do que arrumá-lo. Mas quem conversa o dia inteiro não consegue parar e julgar com calma onde cada coisa mora. É assim que um cérebro vira depósito: cheio, e ninguém sabe o que ali é verdade.
O agente da VPS deixa de escrever em qualquer lugar e passa a escrever numa caixa de entrada. Você, com o Guardião, decide o que daquilo vira memória.
O que muda na prática
| Situação | Como é hoje | Como fica |
|---|---|---|
| Você conta algo ao agente no Telegram | Ele escolhe uma gaveta e escreve lá | Ele escreve na caixa de entrada, com a proposta de onde aquilo deveria morar |
| Uma informação importante chega | Vira memória na hora, sem revisão | Vira memória depois que você aprova — no computador, num resumo do lote inteiro |
| Você procura algo daqui a três meses | Precisa lembrar em que arquivo pôs | O mapa leva até a gaveta e as ligações mostram o que mais importa saber |
| Você trabalha no computador | O que foi feito ali se perde ao fechar | /salvar guarda o resumo da sessão no cérebro |
Por que não deixar o agente escrever direto? Porque memória errada é pior que memória faltando. Uma nota imprecisa que entra no acervo vira "verdade" e contamina toda decisão que vier depois — e ninguém vai lembrar de conferir. O portão de aprovação custa cinco minutos por dia e evita esse tipo de erro que só aparece meses depois.
Três coisas no computador
- Claude Code. É o agente que roda no seu computador. Se ainda não tem, instale com o comando abaixo — precisa do Node.js instalado antes (nodejs.org).
- Git. É o que traz e leva o cérebro entre o seu computador e o GitHub. Em git-scm.com.
- GitHub CLI (
gh). Faz o login no GitHub sem dor de cabeça. Em cli.github.com. Depois de instalar, rodegh auth loginuma única vez.
npm não for reconhecido, instale o Node.js primeiro e abra o PowerShell de novo.npm não for reconhecido, instale o Node.js primeiro e abra o Terminal de novo.Se o PowerShell recusar o script (mensagem sobre "execução de scripts
desabilitada"), use o comando com -ExecutionPolicy Bypass como está em cada
passo. Se ainda assim travar, há um caminho alternativo que sempre funciona: abra o
Git Bash — ele veio junto com o Git — e rode a versão .sh do
mesmo passo, com bash 01-clonar.sh. Os dois fazem exatamente a mesma coisa.
Baixe tudo de uma vez, se preferir. Todos os scripts e prompts desta página estão soltos em cada passo — e também juntos aqui:
No seu computador — montando o Guardião
São oito passos. Os três primeiros são scripts que fazem o trabalho por você; os outros são conversas com o Claude, em português, com o texto pronto para copiar. Cada script pode ser rodado mais de uma vez sem estragar nada — se algo der errado no meio, é só repetir.
Onde salvar os arquivos baixados: crie uma pasta qualquer (por exemplo
Downloads\cerebro-setup), guarde tudo lá e abra o terminal nessa pasta.
Os scripts sabem se localizar sozinhos a partir daí.
Trazer o cérebro para o computador
Hoje o seu cérebro existe em dois lugares: dentro da VPS e no GitHub. Falta a terceira cópia — a do seu computador, onde o trabalho de curadoria acontece. Este script confere o ambiente, traz o repositório e anota onde ele ficou.
Authentication failed, falta rodar gh auth login.
Criar o Guardião
O Claude Code, sozinho, é um assistente genérico. O que o transforma no Guardião do seu
cérebro é um arquivo: o CLAUDE.md. Ele é lido automaticamente toda vez que você
abre o Claude naquela pasta — e diz quem faz o quê, onde cada coisa mora, o que nunca pode
ser feito e como falar com você.
É o mesmo papel que o AGENTS.md cumpre para o agente da VPS. Sem ele, o Claude
trata seu cérebro como uma pasta qualquer de arquivos.
Este script escreve quatro coisas dentro do seu cérebro:
A constituição: quem escreve onde, como se decide o destino de uma nota, o que nunca pode acontecer.
Como uma nota é escrita: cabeçalho, nome de arquivo, links, o formato do texto.
A caixa de entrada (é o passo 3) — com o manual dela dentro.
Onde ficam os scripts de manutenção. Fica fora do backup de propósito: script é ferramenta, não memória.
Se você já tinha um CLAUDE.md ali, o script não apaga: ele
guarda uma cópia .bak antes de trocar. Vale abrir e conferir se havia algo seu
que precisa voltar.
A caixa de entrada
A inbox/ é a porta de entrada de tudo que ainda não foi entendido. É o que
permite ao agente da VPS registrar sem medo de bagunçar: ele deposita ali, e o material fica
claramente marcado como ainda não é memória oficial.
A pasta já foi criada pelo script do passo 2, junto com o _index.md — o manual
que explica quem escreve ali, em que formato, e quem tira de lá.
Atenção — isto sozinho não basta. A pasta existe no seu computador, mas o backup automático da VPS ainda não sabe que ela existe. Enquanto o passo 2 da parte B não for feito, o que o agente escrever na caixa de entrada fica preso no servidor e nunca chega até aqui.
Depois dos passos 2 e 3, suba o que foi criado:
git add . — um arquivo solto com senha entraria junto e ficaria para sempre no histórico do GitHub.A skill /ingestao
Uma skill é um procedimento salvo: em vez de explicar o passo a passo toda
vez, você digita um comando e o agente segue o roteiro. A /ingestao é o
procedimento mais importante do seu cérebro — é ela que transforma caixa de entrada em
memória.
O que ela faz, na ordem
- Puxa o cérebro do GitHub antes de ler qualquer coisa — o agente da VPS pode ter escrito nos últimos 30 minutos.
- Lê o lote inteiro da caixa de entrada. Item isolado engana: dois recados soltos podem ser a mesma história.
- Decide o destino de cada item, o que muda no resto do cérebro e com o que aquilo se conecta.
- Te mostra um resumo em prosa — o que entra, o que muda, o que ele não soube resolver. Este é o portão.
- Só depois do seu OK, grava, arquiva o material bruto e sobe para o GitHub.
Por que um resumo do lote e não item por item? Porque validar trinta itens um a um vira trabalho chato, e trabalho chato é abandonado em duas semanas. Um resumo do lote inteiro você lê em dois minutos e responde numa mensagem só.
/ingestao fica disponível
só dentro da pasta do cérebro — é lá que ela faz sentido. Em qualquer outro
projeto seu, ela nem aparece.
A skill /salvar
Toda conversa com um agente termina e some. Se você passou uma hora resolvendo algo com o
Claude — em qualquer pasta, em qualquer projeto — aquele raciocínio se perde ao fechar a
janela. O /salvar é o "salvar o jogo": ele escreve o resumo da sessão na caixa
de entrada do cérebro e sobe para o GitHub.
Diferente da /ingestao, esta skill é global: funciona de
qualquer pasta do computador, porque ela sabe sozinha onde o seu cérebro mora.
Por que o resumo vai para a caixa de entrada e não direto para a memória?
Porque no fim de uma sessão você sabe o que aconteceu, mas ainda não sabe o que
aquilo significa para o resto do cérebro. Essa decisão é da /ingestao,
com você olhando.
Consertar os mapas
Cada pasta do seu cérebro tem um MAPA.md: um índice que diz o que existe ali e
quando usar. É por ele que os agentes se orientam — em vez de abrir arquivo por arquivo
procurando, eles leem o mapa e vão direto.
Você vem usando o cérebro desde o fim de julho, e os mapas nasceram antes disso. Este passo confronta cada mapa com o que existe de verdade hoje e corrige as diferenças. Mapa desatualizado é pior que mapa nenhum — ele manda a gente para o lugar errado com confiança.
Ligar as notas umas às outras
Uma nota isolada responde uma pergunta. Uma nota ligada às outras responde a pergunta e ainda avisa o que você não sabia que precisava perguntar. É a diferença entre um arquivo morto e um cérebro.
O script abaixo lê o cérebro inteiro e monta um raio-X: links quebrados, notas sem cabeçalho, notas ilhadas (que ninguém alcança navegando) e — o principal — pares de notas que provavelmente têm relação e ainda não estão ligadas.
Com o relatório na mão, é a vez do Claude julgar:
A régua que separa ligação boa de ruído
✓ Vale ligar quando as duas notas tratam do mesmo objeto concreto: mesmo fornecedor, mesma loja, mesma pessoa, mesma decisão em aberto.
× Não vale quando é só assunto parecido — "as duas falam de compras" — ou quando o vínculo é "a ideia daqui serve ali". Esse critério liga tudo com tudo e o mapa perde o valor.
✓ Toda ligação leva uma frase de explicação. Sem ela, quem lê abre tudo no escuro ou não abre nada.
Por que isto não usa inteligência artificial paga? Em cérebros grandes (centenas de notas), comparar todas com todas é caro — aí se usa um filtro estatístico pago para escolher os melhores candidatos antes de julgar. O seu cérebro ainda cabe inteiro na leitura do Claude, então o julgamento é feito sobre o conteúdo real das notas: mais preciso, e sem custo nenhum além do que você já paga. Quando passar de umas 150 notas, esta página ganha a versão com o filtro — o formato do relatório já está preparado.
O padrão que faz tudo se encaixar
Um segundo cérebro não precisa ter a estrutura de pastas de ninguém — a sua funciona bem e permanece como está. O que ele precisa é de um padrão, para que dois agentes diferentes, em máquinas diferentes, escrevam do mesmo jeito e consigam se coordenar.
Esse padrão está no PADROES.md, instalado no passo 2. Três coisas importam:
Toda nota começa com um bloco que diz o tipo, a área, a data e com o que se relaciona. É o que permite achar sem lembrar o nome do arquivo.
Link no texto para navegar; caminho no cabeçalho para indexar. Quem faz só um dos dois tem um cérebro que ou não se lê, ou não se busca.
MEMORY.md e USER.md têm tamanho máximo. Passou, o excedente é cortado no boot sem aviso — e o agente perde memória sem ninguém perceber.
Na VPS — o agente muda de papel
Duas mudanças no servidor. Você não precisa saber mexer em servidor: quem executa é o próprio agente, no Telegram. Você manda o texto, ele faz e te mostra o resultado.
Antes de colar cada prompt, mande /new na conversa. Isso limpa a memória da
conversa anterior e evita que ele misture assuntos.
O agente passa a escrever só na caixa de entrada
Hoje ele escreve em qualquer gaveta. A partir daqui, escreve em uma só —
inbox/ — e continua lendo o cérebro inteiro para se contextualizar. Isso não
diminui o que ele faz: muda o que é considerado definitivo.
O prompt também ensina o agente a se orientar pelos mapas e pelas ligações que você criou nos passos 6 e 7 — em vez de sair procurando arquivo no escuro.
Se ele pedir para escrever direto numa gaveta — porque você pediu — ele
vai explicar a regra, registrar na caixa de entrada mesmo assim e avisar que aquilo entra
de verdade quando você rodar /ingestao. Se você insistir, ele faz: o cérebro é
seu.
Backup da caixa de entrada e rotinas de higiene
Este é o passo que não pode ser pulado. O backup automático do seu
cérebro sobe uma lista fixa de pastas, e a inbox/ não está nela. Sem este
conserto, tudo que o agente capturar fica preso no servidor: você não vê no computador, e
some junto se o servidor morrer.
O script também instala duas rotinas automáticas:
Como saber que funcionou
O prompt termina com um teste: o agente cria um arquivo na caixa de entrada, roda o backup na
hora e mostra o resultado. Se o arquivo aparecer no GitHub, a ponte está de pé — e o próximo
/ingestao no seu computador já vai enxergá-lo.
Como fica o seu dia
| Quando | Onde | O que você faz |
|---|---|---|
| O dia inteiro | Telegram | Conversa com o agente como sempre. Ele captura tudo na caixa de entrada. Você não muda nada no seu hábito. |
| 2 ou 3 vezes por semana | Computador | Abre o Claude na pasta do cérebro e digita /ingestao. Lê o resumo, aprova, corrige. Cinco minutos. |
| Ao terminar de trabalhar no PC | Computador | Digita /salvar. O que você fez ali não se perde. |
| De vez em quando | Computador | Roda o mapear-contexto.py e deixa o Claude propor novas ligações. |
Quando você perguntar algo ao agente e ele responder com um detalhe que você contou há dois meses e já tinha esquecido.
O risco real não é técnico. É a caixa de entrada acumular por três semanas até virar um monte grande demais para revisar — e aí o hábito morre. Por isso o placar diário existe: enquanto ele estiver em silêncio, está tudo em dia.
Checklist final
✓ A pasta do cérebro existe no computador e git pull funciona sem pedir senha.
✓ Abrindo o Claude nessa pasta, ele se apresenta sabendo que é o Guardião.
✓ /ingestao aparece na lista de comandos dentro da pasta do cérebro.
✓ /salvar aparece em qualquer pasta.
✓ Os MAPA.md refletem as pastas que existem hoje — incluindo a inbox/.
✓ O relatório de contexto foi gerado e as primeiras ligações foram aprovadas.
✓ O agente da VPS confirmou por escrito que passou a escrever só na inbox/.
✓ Um arquivo criado na inbox/ pelo servidor apareceu no GitHub — e chegou ao computador com git pull.
✓ hermes cron list mostra cerebro-sync, higiene-cerebro e revisao-semanal.
Travou em algum passo?
Não force. Cada script pode ser rodado de novo sem estragar nada, e nenhum deles apaga
arquivo — no máximo guarda uma cópia .bak. Copie a mensagem de erro exatamente
como apareceu e leve para a sessão de suporte da comunidade.