MODULO 3-6

🧠 Cerebros β€” o motor que pensa e a memoria organizada

"Cerebro" do Jarvis tem dois sentidos, e os dois importam. O primeiro e o motor LLM β€” o modelo que pensa, e que voce pode trocar sem mexer no codigo. O segundo e a memoria organizada β€” o "segundo cerebro" dividido em zonas. Neste modulo, ultimo da Anatomia, voce vai entender os dois β€” e por que NAO existe um "conselho magico de modelos" votando.

6
Topicos
~50
Minutos
Intermediario
Nivel
Pratico
Tipo
1

βš™οΈ O cerebro = o motor LLM

Ao longo da Anatomia voce montou canais (por onde fala), identidade (quem ele e), ferramentas (as maos), skills (as receitas) e agentes (o loop que trabalha sozinho). Falta a peca que de fato pensa: o cerebro. No primeiro sentido, "cerebro" e o motor LLM β€” o modelo de linguagem que recebe o contexto, raciocina e devolve texto. Tudo o que voce construiu so ganha vida quando esse motor esta plugado.

A grande ideia deste modulo: esse motor e uma peca plugavel. Ele nao esta soldado ao resto do Jarvis. O codigo do agente fala com o motor por uma interface padrao (uma "tomada"), entao da pra desencaixar um modelo e encaixar outro sem reescrever nada. Por isso a frase que resume tudo: "um cerebro, varias bocas" β€” e, aqui, varios cerebros possiveis, uma so arquitetura.

🧩 O motor por baixo de tudo

Pense no Jarvis como um carro que voce ja montou: a carroceria (canais), o painel (identidade), as rodas (ferramentas). O motor e o LLM. O carro inteiro depende dele β€” mas o motor e so mais uma peca, e pecas se trocam.

  • β€’O motor recebe: contexto (sua mensagem + SOUL.md + memoria + resultados de ferramentas).
  • β€’O motor devolve: texto β€” uma resposta, ou um pedido de ferramenta para o loop agentico.
  • β€’O resto do Jarvis nao "sabe" qual motor esta rodando β€” so conversa com a tomada.

Novo aqui? LLM ("Large Language Model", modelo de linguagem grande) e o programa treinado em muito texto que prevΓͺ a proxima palavra β€” e o cerebro que roda atras do ChatGPT, do Claude ou de modelos locais. Provedor e quem fornece esse cerebro: Anthropic, OpenAI, OpenRouter (que junta varios) ou o seu proprio PC via Ollama. Interface aqui e o "encaixe" padrao pelo qual o codigo fala com qualquer um deles do mesmo jeito.

Conceitos-chave

Motor LLM

O modelo que de fato pensa: recebe contexto, devolve texto.

Peca plugavel

O cerebro nao esta soldado: encaixa e desencaixa por uma tomada.

Um cerebro, varias bocas

O mesmo modelo atende Telegram, voz, web β€” vozes diferentes, um cerebro.

Provedor

Quem fornece o motor: Anthropic, OpenRouter, Ollama local...

2

πŸ”Œ Trocar de cerebro sem mexer no codigo

Se o motor e plugavel, trocar de cerebro deveria ser tao simples quanto trocar uma lampada β€” e e. Em um Jarvis bem feito, o modelo nao aparece espalhado pelo codigo: ele e declarado em um unico lugar, o arquivo .env. Mude duas linhas la, reinicie, e o Jarvis inteiro passa a pensar com outro modelo. Isso se chama hot-swap (troca a quente).

Por que isso importa tanto? Porque cada tarefa tem um motor ideal. Uma pergunta boba ("que horas sao em Tokio?") nao precisa do modelo mais caro do mundo; um problema cabeludo de raciocinio merece o de fronteira. Trocar de cerebro vira uma decisao economica β€” voce escolhe potencia ou custo conforme a tarefa, e nao fica refem de um unico fornecedor.

πŸ“Š Tres motores, tres perfis

  • β€’Nuvem potente (Anthropic Claude, GPT): melhor raciocinio, paga por token (cada pedacinho de texto que entra ou sai β€” voce paga pelo volume). Para tarefas dificeis.
  • β€’Nuvem barata (via OpenRouter): acesso a dezenas de modelos baratos por uma so chave. Para tarefas medias.
  • β€’Local (Ollama no seu PC): $0 por uso, privado, offline. Modelos por RAM (3B@8GB, 8B@16GB); CPU e lento (30–60s).
Copy-run Β· trocar o cerebro no .env font-mono

Objetivo: fazer o Jarvis pensar com um modelo diferente sem tocar no codigo β€” so editando o arquivo .env na raiz do projeto.

1) Nuvem potente (Anthropic). Cole no seu .env:

LLM_PROVIDER=anthropic
LLM_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=<sua-chave-anthropic>

2) Quer nuvem barata via OpenRouter? Troque so estas linhas:

LLM_PROVIDER=openrouter
LLM_MODEL=<modelo-barato-ex-meta-llama/llama-3.1-8b-instruct>
OPENROUTER_API_KEY=<sua-chave-openrouter>

3) Quer 100% local e gratis? Suba o Ollama e aponte pra ele:

LLM_PROVIDER=ollama
LLM_MODEL=<modelo-local-ex-llama3.2>
OLLAMA_HOST=http://localhost:11434

Como verificar: reinicie o Jarvis e mande no canal: "qual modelo voce esta usando agora?". Se o codigo loga o provedor na inicializacao, voce vΓͺ algo como [brain] provider=ollama model=llama3.2. O comportamento muda (velocidade, qualidade), mas voce nao tocou em nenhuma linha de codigo β€” so no .env. Isso e o hot-swap funcionando.

Conceitos-chave

Hot-swap

Trocar o motor mudando o .env e reiniciando β€” sem mexer no codigo.

.env

Arquivo de configuracao/segredos; o unico lugar onde o modelo e declarado.

Decisao economica

Modelo barato para tarefa simples, premium para a dificil.

OpenRouter / Ollama

Um agregador de modelos na nuvem; um runtime de modelos no seu PC.

3

πŸͺ§ O mito do "conselho de modelos"

Quando alguem ouve "varios cerebros", a imaginacao corre solta: cinco modelos sentados a uma mesa, debatendo, votando, e um juiz escolhendo a melhor resposta. E uma imagem bonita β€” e, nos projetos reais deste curso, ela nao existe. Nao ha um roteador magico que consulta N modelos ao mesmo tempo e tira a media. Seja honesto sobre isso: e marketing, nao arquitetura.

⚠️ Cuidado com a promessa do "conselho"

Rodar varios LLMs de fronteira em paralelo, para cada mensagem, custa caro, fica lento e raramente melhora a resposta de forma confiavel. Quem te vende um "comite de IAs votando" geralmente esta vendendo complexidade que voce nao precisa β€” e que voce nao consegue auditar.

A tese deste curso e o oposto: menos e mais. Codigo que voce entende vale mais que um conselho que voce nunca vai conseguir depurar.

Entao, quando os projetos falam em "multiplos modelos", o que isso significa de verdade? Duas coisas concretas e honestas: substituicao (o hot-swap do topico 2 β€” trocar um pelo outro) e portabilidade β€” a mesma skill rodando em runtimes diferentes (Claude Code, Codex) via a spec de Agent Skills e ferramentas como o polyskill. Nao e votacao simultanea; e a mesma fonte funcionando em mais de um cerebro.

βœ“ "Multiplos modelos" honesto

  • βœ“Substituicao: trocar o motor por .env quando convem.
  • βœ“Portabilidade: a mesma skill roda em Claude Code E Codex.
  • βœ“Sub-agente delega a um modelo proprio e devolve so a resposta (T3-5).
  • βœ“Voce entende e audita cada peca.

βœ— O mito do conselho

  • βœ—5 modelos votando em cada mensagem.
  • βœ—Um "juiz" magico que escolhe a melhor resposta.
  • βœ—Custo e latencia multiplicados sem ganho garantido.
  • βœ—Uma caixa-preta que voce nao consegue depurar.

Novo aqui? Runtime e o "ambiente" onde a IA roda (Claude Code, Codex, Cursor...). Portabilidade e a mesma receita funcionar em mais de um runtime sem reescrever. polyskill e uma ferramenta que empacota uma skill numa fonte unica e a faz rodar em runtimes diferentes β€” o "multiplos modelos" de verdade.

Conceitos-chave

Conselho de modelos (mito)

A ideia de N LLMs votando ao vivo β€” que os projetos reais nao usam.

Substituicao

Um motor por vez, trocado conforme a tarefa.

Portabilidade (cross-runtime)

A mesma skill em Claude Code, Codex etc. (polyskill).

Menos e mais

Codigo auditavel vence complexidade impressionante.

4

πŸ“’ O "segundo cerebro" vira memoria

Agora o segundo sentido de "cerebro". Voce ja viu na Identidade (T3-2) que a conversa esquece ao fechar β€” a janela de contexto e como a RAM, esvazia. Para o Jarvis lembrar de voce de verdade, ele precisa de memoria persistente: anotacoes que sobrevivem entre as sessoes. Esse acervo e o que chamamos de segundo cerebro β€” emprestando o termo da produtividade pessoal (o "Building a Second Brain" do Tiago Forte): um sistema externo onde voce guarda o que nao cabe na cabeca.

Mas aqui vem o perigo. Se voce simplesmente joga TUDO num monte de notas β€” decisoes, fatos, sentimentos, lembretes β€” o segundo cerebro incha e vira um sotao bagunΓ§ado. Quando o Jarvis precisa achar algo, encontra ruido. A solucao nao e ter menos memoria; e organiza-la em zonas, cada uma com um proposito. E dai que nasce a ideia dos "3 cerebros" (proximo topico).

1

Sem memoria

Cada conversa comeca do zero. Ele te trata como estranho todo dia.

2

Memoria como monte unico

Ele lembra β€” mas tudo no mesmo balde. Acha ruido, mistura fato com sentimento, incha.

3

Memoria organizada em zonas

Cada coisa no seu lugar (Projeto / Self / Conhecimento). Ele acha rapido e raciocina melhor.

Novo aqui? Memoria persistente e a que sobrevive ao fechar a conversa β€” guardada em arquivos no disco, nao na janela de contexto. Segundo cerebro e o nome desse acervo externo de notas. Inbox (caixa de entrada) e onde toda nota nova cai primeiro, antes de ser arquivada na zona certa.

Conceitos-chave

Segundo cerebro

Acervo externo de notas que sobrevive entre sessoes.

Memoria persistente

O que fica no disco, ao contrario da janela de contexto que esvazia.

Inchaco do monte unico

Tudo no mesmo balde vira ruido; o problema nao e quantidade, e ordem.

Organizar em zonas

Separar por proposito da ordem e melhora a busca.

5

🧠 Os 3 cerebros (memoria)

Aqui esta o coracao do segundo sentido de "cerebros". Em vez de um monte de notas, a memoria do Jarvis se divide em tres zonas, cada uma com uma natureza diferente. Pense em tres gavetas de um arquivo: o que muda toda hora nao mora junto com o que quase nunca muda.

CEREBRO 1 Β· o motor LLM (trocavel) anthropic openrouter ollama (local) .env agente a tomada CEREBRO 2 Β· a memoria (3 zonas) πŸ“₯ inbox unica/triagem roteia Projetoepisodicoo que rolou,decisoes Selfidentidadevalores, duvidasmuda devagar Conhecimentoreferenciafatos que soacumulam [[wikilinks]] cruzam as tres zonas

A esquerda, o motor LLM e trocavel: tres provedores entram na mesma "tomada" do agente via .env. A direita, a memoria e dividida: uma inbox unica recebe tudo e a skill /triagem roteia para Projeto (o que rolou), Self (quem ele e) ou Conhecimento (fatos). Os [[wikilinks]] costuram as tres.

πŸ“¦ Projeto (episodico)

O que aconteceu: tarefas, decisoes, o andamento das coisas. Muda toda hora β€” e o "diario" do Jarvis.

πŸͺͺ Self (identidade)

Quem ele e e quem voce e: valores, tom, preferencias, duvidas em aberto. Muda devagar β€” e estavel de proposito.

πŸ“š Conhecimento (referencia)

Fatos que so acumulam: receitas, contatos, anotacoes de estudo. Quase nunca apaga β€” so cresce.

πŸ”— A cola entre as zonas

Uma inbox unica recebe toda nota nova; uma skill /triagem le e roteia cada uma para a zona certa β€” voce nao precisa decidir na hora. E os [[wikilinks]] (aquele "[[nome]]" entre colchetes duplos, herdado de wikis e do Obsidian) ligam uma nota a outra atravessando as tres zonas: uma decisao de Projeto pode apontar para um valor de Self e para um fato de Conhecimento.

Conceitos-chave

Projeto (episodico)

O que rolou e as decisoes β€” a memoria que muda toda hora.

Self (identidade)

Valores e duvidas β€” a memoria que muda devagar.

Conhecimento (referencia)

Fatos que so acumulam.

Inbox + /triagem + [[wikilinks]]

Uma entrada que roteia, e links que cruzam as tres zonas.

6

πŸ—‚οΈ Memoria = filesystem + indice

Como, na pratica, essa memoria existe no disco? A resposta e desconcertantemente simples β€” e por isso ela e robusta. A memoria do Jarvis sao arquivos de texto (formato .md, Markdown) que voce mesmo consegue abrir e ler. Esses arquivos sao a verdade. Por cima deles roda um indice de busca (SQLite com FTS5/BM25) que e so um atalho para achar a nota certa rapido β€” se o indice sumir, voce reconstroi a partir dos arquivos.

A VERDADE Β· arquivos .md projeto/decisoes.md self/valores.md conhecimento/notas.md legivel Β· versionavel Β· so texto indexa reconstroi O ATALHO Β· indice (descartavel) SQLite FTS5 / BM25 busca por palavra sumiu? reconstroi dos .md O ROTEADOR Β· CLAUDE.md CLAUDE.md / AGENTS.md lido no INICIO de cada sessao aponta onde achar cada coisa

Os arquivos .md sao a verdade β€” legiveis e versionaveis. O indice SQLite e so um atalho de busca: se sumir, reconstroi a partir dos arquivos. E o CLAUDE.md e o roteador lido no inicio de cada sessao, dizendo ao Jarvis onde achar cada cerebro de memoria.

🧭 O CLAUDE.md e o roteador

No comeco de cada sessao, o Jarvis le um arquivo-mestre β€” o CLAUDE.md (ou AGENTS.md). Ele nao guarda tudo: ele aponta. "Decisoes ficam em projeto/. Meus valores em self/. Para buscar fato, use o indice." E o mapa que diz onde estao os tres cerebros β€” por isso e a primeira coisa lida.

E a mesma logica do contrato de Identidade (T3-2): o arquivo no inicio define o jogo.

πŸ’‘ Por que isso sobrevive ao hype

Modas de IA vem e vao, mas texto e texto. Sua memoria em arquivos .md abre em qualquer editor, entra no Git, migra para qualquer ferramenta futura. Voce nao fica refem de um banco de dados proprietario nem de um formato que so uma empresa entende. "Sobrevive porque e so texto."

Novo aqui? Filesystem e simplesmente o sistema de arquivos do seu computador β€” pastas e arquivos. SQLite e um banco de dados que cabe num unico arquivo. FTS5/BM25 sao o mecanismo de "busca por texto completo" do SQLite e a formula que ordena os resultados por relevancia (busca por palavra). Um banco vetorial e uma alternativa que busca por significado em vez de palavra β€” util quando voce nao lembra o termo exato.

Conceitos-chave

Arquivos .md = a verdade

Texto legivel no disco; tudo o mais e derivado deles.

SQLite FTS5/BM25

Indice de busca por palavra; um atalho descartavel e reconstruivel.

CLAUDE.md = roteador

Lido no inicio da sessao; aponta onde mora cada cerebro.

Banco vetorial

Busca por significado, alternativa/complemento ao FTS5.

Auto-checagem (opcional): no modelo deste curso, o que "cerebros" significa?

🎯 Resumo do modulo

βœ“
O cerebro = o motor LLM β€” a peca que pensa, plugavel por uma tomada padrao. "Um cerebro, varias bocas."
βœ“
Hot-swap por .env β€” troca de motor (anthropic / openrouter / ollama) sem mexer no codigo; decisao economica por tarefa.
βœ“
Nao existe "conselho de modelos" β€” "multiplos modelos" honesto = substituicao + portabilidade (polyskill), nao votacao simultanea.
βœ“
O segundo cerebro vira memoria β€” um monte unico incha; organizar em zonas da ordem.
βœ“
Os 3 cerebros β€” Projeto (episodico), Self (identidade), Conhecimento (referencia) + inbox/triagem + [[wikilinks]].
βœ“
Memoria = filesystem + indice β€” .md sao a verdade, SQLite FTS5 e o atalho, CLAUDE.md e o roteador. Sobrevive porque e so texto.

Voce concluiu a Anatomia (Trilha 3):

Canais Β· Identidade Β· Ferramentas Β· Skills Β· Agentes Β· Cerebros. As 6 camadas que viram um chat num assistente que vΓͺ, lembra e age. Proximo: na Trilha 4 voce junta tudo isso numa arquitetura e constroi.