⚙️ O mecanismo

Todo mundo promete que a IA lembra. Aqui está a conta que decide o que ela lê primeiro.

Esta página não tem rótulo para vender. Tem a célula do grafo, a aritmética que ordena a atenção — que você pode conferir no papel —, o ciclo que corrige o próprio erro e as três críticas mais duras que a categoria levou em 2026, respondidas com mecanismo em vez de adjetivo.

A célula
O radar no papel
O ciclo
A pilha
As três críticas
Experimente

A célula do grafo: um nó e uma aresta

Conhecimento aqui não é documento. É um conjunto de afirmações tipadas, cada uma com um identificador cujo prefixo já diz que tipo de coisa ela é — porque um palpite e uma medição não podem parecer a mesma frase.

D_decisão — o que foi resolvido

E_evidência — o que foi medido

C_afirmação — o que se acredita

Q_pergunta — o que segue em aberto

A_artefato — a coisa concreta citada

Um exemplo inteiro, de uma empresa fictícia — a Café Aroma — que decidiu que desconto tem teto de 10%:

nodes:
  - id: D_desconto_max_10
    node_type: decision
    impact: 5              # o preco de errar aqui: alto
    confidence: 0.9
    status: confirmed
    label: "Teto de desconto: 10%, sem excecao"
    verified_at: 2026-08-25
    verified_against: "playbook comercial vigente"

  - id: E_black_friday_2024
    node_type: evidence
    impact: 4
    confidence: 1.0
    status: confirmed
    label: "BF 2024: 30% de desconto -> churn 3x em 6 meses"

edges:
  - from: E_black_friday_2024
    to:   D_desconto_max_10
    edge_type: SUPPORTS   # a decisao nao esta solta: tem chao

Os quatro números que todo nó carrega

Campo	Faixa	O que significa de verdade
impact	1 a 5	O preço do erro, não a importância. A pergunta não é "isso é relevante?", é "quanto custa se isto estiver errado?". Uma decisão de precificação e uma preferência de formatação podem ser igualmente relevantes e nunca custar o mesmo.
confidence	0 a 1	O quanto a afirmação se sustenta. Não é entusiasmo: 0,6 é uma coisa que você defenderia numa reunião e não apostaria a empresa.
status	enum	O que o grafo já sabe sobre esse nó — e cada valor vira um multiplicador na conta da próxima seção: em aberto ×1 · confirmado ×1 · divergiu ×1,3 · não verificável ×1 · refutado ×0 · superado ×0,2 · encerrado ×0,1.
verified_at	data	Carimbo de validade. Diz quando alguém mediu isso contra o mundo real — e, no campo vizinho, contra o quê. Um nó sem carimbo é sinalizado ⚠ STALE pelo próprio instrumento. Não é reprovação; é o mapa admitindo que aquele ponto pode ter envelhecido sem avisar.

Repare no ×0 do refutado. Uma verdade que cai não é apagada: ela troca de estado, ganha a aresta REFUTES de quem a derrubou, e passa a valer zero na conta de atenção. Ela some do topo da fila, não da história. Quem chegar depois lê o que se pensava antes e o motivo de ter mudado — que é exatamente o que um git merge num documento em prosa destrói sem deixar registro.

O radar no papel

Um grafo com centenas de afirmações torna "leia tudo" uma instrução vazia. Então cada nó recebe um número — a atenção — e esse número é calculado, não opinado:

atenção = impacto × confiança × fator do estado × (1 + ligações)

É só isso. Quatro campos que já estavam no arquivo, três multiplicações e uma soma. O (1 + ligações) é a centralidade: quanto mais coisas encostam num nó, mais caro sai errar nele — uma decisão isolada erra sozinha, uma decisão que sustenta outras quatro erra em cinco lugares.

Mexa nos controles. O exemplo já vem carregado com o teto de 10% da seção anterior — impacto 5, confiança 0,9, confirmado, quatro arestas encostando nele:

Impacto 5 o preço de errar aqui — 1 a 5 Confiança 0,90 o quanto se sustenta — 0 a 1 Estado o que o grafo sabe sobre este nó Ligações 4 quantas arestas encostam nele

Atenção22,5

Determinístico, sem IA, refazível no papel.

Arraste o estado até refutado e veja a atenção cair a zero sem que nada mais mude: é o mapa dizendo "isto continua registrado, e não é mais para onde você olha". Arraste até divergiu e ela sobe acima do confirmado — um nó que acabou de provar que o mundo andou é mais urgente que um que está apenas em dia, porque alguém precisa reconciliar.

Nenhuma dessas contas passa por um modelo. É um script — mesma entrada, mesma saída, custo zero, auditável linha a linha. Você acabou de rodar o mesmo cálculo que ordena a fila de trabalho real, no seu navegador, sem rede.

O que a conta não faz

Ela mede onde olhar, nunca o que é verdade. Atenção alta não significa "isto está certo": significa "se isto estiver errado, dói". E a conta é tão boa quanto os números que alguém digitou — um impacto inflado sobe um nó que não merecia. O instrumento ordena a fila; ele não confere o conteúdo dela. Publicamos isto junto com a fórmula de propósito: um instrumento que não declara o próprio limite é pior que instrumento nenhum.

O ciclo: read → verify → act → write

O grafo não é arquivo morto que alguém consulta. Ele é o primeiro e o último ato de todo trabalho: lê-se antes de decidir, mede-se contra o mundo antes de acreditar, age-se, e o que se aprendeu volta carimbado. O melhor jeito de mostrar isso é um caso em que a vítima do erro foi este site.

Por volta de um mês, a página inicial daqui mentiu — ela anunciava um inventário de 98 comandos quando o número real já era 102. Ninguém tinha escrito nada errado.

read

O grafo já tinha um nó sobre isso, de julho: "o site está defasado", com a causa apontada para autoria atrasada — alguém precisava reescrever a página. O nó estava lá, plausível, e teria bastado para gerar uma tarefa errada.
verify

Em vez de acreditar no nó, medimos. Baixamos a página viva e comparamos com a fonte no repositório. A fonte estava certa: um commit de 30 de julho tinha atualizado o inventário e a página no mesmo commit, e a string antiga nem existia mais no arquivo. O nó estava certo no sintoma e errado na causa. O que estava quebrado não era a escrita — era a publicação, que existia só como prosa: um procedimento que alguém devia lembrar de executar.
act

A correção óbvia — reescrever a página — não corrigiria nada. E republicar à mão é a mesma falha esperando o mês seguinte. Então o que foi entregue não foi uma republicação: foi o mecanismo de publicação, com lista fechada do que pode ir ao ar, uma verificação por hash que compara fonte e site vivo e falha quando divergem, e um autoteste que congela os ataques encontrados em duas rodadas de revisão adversarial — inclusive o pior deles: uma fonte vazia que apagava o site inteiro devolvendo veredito verde.
write

O nó antigo não foi corrigido nem apagado: foi marcado como superado, com a data em que foi medido e contra o que. Um nó novo, ligado a ele, registra o mecanismo que nasceu e o que passou a servir. Se a defasagem voltar, quem chegar depois encontra a história inteira — o sintoma, a causa errada, a causa certa e a guarda que ficou.

A lição, e a razão de o ciclo ter quatro verbos e não três: a verificação foi contra o vivo, não contra o repositório. Um histórico limpo teria confirmado, com toda a autoridade de um teste que passa, a versão errada dos fatos.

A pilha: quem age, o que sabe fazer, em que ordem

Três peças, e a distinção entre elas é o que impede a coisa toda de virar um prompt gigante:

Agente quem age

Um papel com fronteira declarada: quais ferramentas pode usar, que contexto carrega, e o que não lhe cabe decidir. É um especialista com escopo, não um assistente genérico — e a fronteira existe para que a resposta dele possa ser conferida por quem o chamou.

Skill o que se sabe fazer

Um procedimento nomeado e versionado, que qualquer agente carrega quando o assunto aparece. Conhecimento em forma de instrução executável, no repositório, revisável em diff — não um prompt colado que só existe na cabeça de quem escreveu.

Workflow em que ordem

A sequência de fases, retomável: cada fase tem entrada, saída e estado durável em disco. A sessão cai, o trabalho não. É o que permite que uma investigação longa sobreviva ao fim da janela de contexto — e que outra pessoa continue de onde parou.

Economy of Motors: use o motor mais barato que dá conta

Nada disso escolhe sozinho com o quê executar. Essa escolha é explícita, e são três motores:

Transformer (o modelo grande) — juízo, síntese, trade-off, texto, orquestração. Caro, lento e não determinístico. Use quando a tarefa exige entender intenção.
SLM como ferramenta — um modelo pequeno e especializado, atrás de uma interface, para tarefa estreita e repetitiva (extrair, classificar, redigir dado sensível localmente). Nunca orquestra: é ferramenta, não agente.
Shell — o determinístico — script puro para tudo aquilo em que o modelo erra: contar, comparar, detectar divergência, aplicar formato fixo. Mesma entrada, mesma saída, custo zero, auditável.

A regra é uma linha: o motor mais barato que dá conta. E o erro mais comum não é usar um modelo pequeno demais — é usar o modelo para contar. O radar da seção anterior é shell exatamente por isso: se a fila de atenção dependesse de inferência, ela mudaria de opinião entre duas execuções idênticas, e um instrumento que faz isso não é instrumento.

As três críticas de 2026, respondidas por mecanismo

Grafos de conhecimento acoplados a agentes levaram três objeções sérias este ano. São críticas à categoria — não a um produto — e todas as três estão certas sobre um modo de falha real. Vale responder com o que a máquina faz, não com adjetivo.

Crítica 1 · custo "O agente não deveria caminhar o grafo por inferência. Dupla inferência dobra o custo: você paga o modelo para descobrir onde olhar e paga de novo para pensar sobre o que achou."

Está certa, e é por isso que aqui o modelo não caminha o grafo. A atenção é computada antes de qualquer chamada ao LLM, por aritmética determinística: impacto × confiança × fator de estado × (1 + ligações) — a mesma conta que você acabou de rodar acima, no seu navegador, sem rede e sem token. O que chega ao modelo já é uma fila ordenada; ele lê o topo, não o mapa inteiro.

A dupla inferência que a crítica descreve acontece quando o grafo é tratado como um índice que o modelo precisa interpretar para saber onde olhar. Aqui o grafo é entrada de uma função, e a função é que decide. O modelo entra depois, para a parte em que ele é insubstituível: julgar o conteúdo. E como a conta é a mesma toda vez, ela é reproduzível — duas execuções idênticas devolvem a mesma fila, o que nenhuma travessia por inferência garante.

Crítica 2 · epistemologia "Inferência escrita de volta no grafo vira fato. Sem uma camada epistêmica, o palpite de ontem é lido amanhã como medição, e o sistema passa a se citar como fonte."

Esta é a mais séria das três, porque descreve exatamente como um grafo vira máquina de lavar palpite: o modelo infere, a inferência é gravada, e na leitura seguinte ela é indistinguível de algo que alguém mediu. A resposta aqui é que a camada epistêmica não é opcional — é o schema. Todo nó é tipado (decisão, evidência, afirmação, pergunta, artefato), carrega uma confiança de 0 a 1, um estado declarado, e diz contra o que foi verificado e quando. Uma afirmação de confiança 0,6 sem carimbo de verificação não se parece com uma evidência medida — nem no arquivo, nem na fila do radar, que a trata como outra coisa.

E quando duas verdades colidem, elas não se sobrescrevem. A nova entra ligada à velha por REFUTES ou SUPERSEDES, e a velha permanece: troca de estado e é rebaixada na conta — refutada vale zero, superada vale um quinto. O nó derrubado continua no mapa, com a aresta que o derrubou apontando para ele. É a diferença entre um sistema que reescreve o passado e um que reconcilia. Corrigir não apaga; supera.

Crítica 3 · segurança "Envenenamento do grafo. Se a memória dirige o agente, plantar um nó falso é mais barato que escrever um exploit — e muito mais difícil de perceber."

Também está certa, e é a que mais cresce em importância à medida que grafos viram infraestrutura: quem escreve no grafo dirige o agente. Duas coisas seguram isso aqui, e nenhuma delas é confiança.

A primeira é a ordem dos verbos: nada entra sem read → verify. Escrever é o último ato, e o nó carrega o campo que declara contra o que foi medido e em que data. Um nó sem esse campo é sinalizado pelo próprio instrumento, automaticamente — não depende de um revisor atento naquele dia. A segunda é que a escrita não é efeito colateral de runtime: ela é um commit. Passa por diff, por revisão e por histórico, e fica visível no mesmo lugar onde já se olha para código. Um nó que apareceu sem que ninguém tivesse medido nada aparece como uma linha nova numa revisão. O grafo tem proveniência, não fé.

O que isso não resolve, e fica declarado: cobertura não é verdade. A verificação exige que exista proveniência, não que ela seja boa — um nó raso e genérico passa. Estar no grafo significa que alguém modelou, não que alguém conferiu. Enquanto quem alimenta o mapa for um processo com revisão adversarial, esse flanco fica fechado; no dia em que virar rotina apressada, a verificação fica verde sobre um mapa oco — e aí ela mente com a autoridade de um teste que passou.

Experimente no seu domínio (15 minutos)

Nada disto exige instalar o framework, criar conta ou entregar dado nenhum. O método viaja como schema + método. Pegue uma decisão que você tomou esta semana — uma que ainda esteja quente o suficiente para você lembrar do que foi discutido — e escreva quatro coisas:

O que eu decidi. Uma frase, no indicativo. Vira um nó D_. Dê a ela um impacto de 1 a 5 respondendo "quanto custa se isto estiver errado?".
O que sustenta. Os fatos que você usou — um número, um incidente, um teste, uma conversa com cliente. Cada um vira um nó E_ ligado à decisão por SUPPORTS.
O que eu refutei. A alternativa que parecia razoável e foi descartada. É a mais valiosa das quatro e a que todo documento perde: vira um nó C_ com status: refuted e uma aresta REFUTES saindo da evidência que a derrubou. Daqui a três meses, quando alguém propuser exatamente isso de novo, a resposta já está escrita.
O que segue aberto. A dúvida que você não resolveu e decidiu mesmo assim. Vira um nó Q_. Não é fraqueza do mapa — é a parte mais honesta dele. Um mapa só de certezas é um mapa que esqueceu de anotar onde termina.

Rode a conta de atenção em cada nó, à mão ou com o widget acima, e ordene. O que ficar no topo é onde a próxima hora do seu time deveria ir. Se o resultado te surpreender, o exercício já valeu: essa surpresa é a diferença entre a fila que você acha que tem e a que os seus próprios números descrevem.

Comece pelo onion-mini →

Público, sem cadastro — o schema mínimo e o radar, para rodar no seu domínio hoje.

Se rodar, mostre. Poste o seu arquivo (anonimizado) ou conte o que o radar pegou que a prosa escondia. É o tipo de coisa que a gente quer ver funcionar fora da nossa própria casa — e um contraexemplo é mais útil aqui do que um elogio.