VB AI Context

Resumo

O VB AI Context é uma arquitetura local para trabalhar com vários agentes de IA. Contexto, regras, histórico e arquivos ficam em pastas no computador, e qualquer agente conectado trabalha a partir delas.

• Problema: cada IA guardava o próprio contexto. Trocar de conta ou de agente era começar do zero.
• O que eu fiz: criei a estrutura de pastas, as regras de comportamento num arquivo só e os níveis de permissão.
  O Claude Code e o OpenAI Codex leem a mesma base, acessam os arquivos do computador e se conectam a outros aplicativos por MCP.
• Resultado: qualquer agente continua de onde o outro parou. O meu trabalho ficou mais rápido, de landing pages e SaaS a planejamento e análise de dados.
  Um site que levaria 12 dias ficou pronto em 3.
• Stack: Markdown, Obsidian, VS Code, Claude Code, OpenAI Codex e MCP.
• Origem: projeto pessoal, publicado como template no GitHub em setembro de 2026.

Contexto

Eu usava o Claude e o ChatGPT no navegador. Colocava alguns documentos .txt na memória e pensava que agora tinha uma IA com contexto sobre mim.

Era um primeiro passo, mas tinha um problema. Eu ficava à mercê de uma única IA.

Quando os créditos acabavam no meio de uma tarefa, eu esperava voltar ou assinava o plano mais caro.

A outra saída era ir para a minha conta secundária. Só que ela precisava ser ensinada do zero e não continuava de onde eu tinha parado.

Parecia que eu estava construindo um castelo de areia.

Eu gastava energia contextualizando coisas que já tinham sido contextualizadas uma vez.

O que saía dali virava um Frankenstein, sem processo claro e limitado pelo formato da IA na web.

Com o Claude Code dentro do VS Code, isso mudou. Tudo o que é criado vira uma pasta local no computador, com notas em .md, e nada mais se perde.

Eu já usava bastante o Obsidian, com pastas, notas e o Zettelkasten, um método de notas pequenas ligadas entre si. Mais recentemente, passei a usar também a curadoria de fontes descrita por Andrej Karpathy.

Um vídeo da Ana Jords sobre "segundo cérebro" me fez unir esses dois mundos.

A pasta do Obsidian abre no VS Code no mesmo formato. A partir dali, qualquer IA conectada trabalha com o mesmo contexto.

O que eu fiz

Criei o VB AI Context, uma arquitetura em pastas de Markdown onde vários agentes de IA trabalham com o mesmo contexto. Ela não precisa de servidor, banco de dados nem chave de API.

As pastas se dividem em três camadas: X para o conhecimento, Y para os projetos e a vida pessoal, Z para o sistema e o espaço de trabalho da IA.

O conhecimento segue dois fluxos que não se misturam:

• My Thinking, com o pensamento da própria pessoa, no método Zettelkasten;
• Knowledge Base, com fontes externas escolhidas, guardadas intactas e resumidas em uma wiki mantida pela IA, na curadoria descrita por Andrej Karpathy.

A única ponte entre os dois é a promoção. Um conceito da base vai para a caixa de entrada, e a pessoa escreve a própria leitura sobre ele.

O agente lê as regras em um arquivo só, o AGENTS.md. Por isso o Claude Code e o OpenAI Codex trabalham na mesma pasta.

Se uma conta fica sem crédito, outra continua a tarefa de onde ela parou.

Construí sete skills, que são comandos prontos para o agente:

• vault-setup, que configura a pasta e apresenta a estrutura;
• kb-ingest, que guarda uma fonte e cria as notas da wiki;
• kb-query, que responde citando as notas usadas;
• kb-lint, que aponta links quebrados e notas duplicadas;
• kb-promote, que leva um conceito da base para a caixa de entrada;
• zk-process, que transforma capturas em notas do My Thinking;
• vault-translate, que traduz a estrutura para outro idioma.

Permissões de escrita

Defini quatro níveis para onde a IA pode escrever:

• na wiki e no AI Workspace, ela escreve sem perguntar;
• nas fontes brutas, ela só cria arquivos novos, sem editar nem apagar;
• no My Thinking e na caixa de entrada, só quando a skill é chamada;
• em todo o resto, só com permissão dada naquela conversa.

O My Thinking fica protegido porque guarda o pensamento da pessoa. Uma IA não escreve isso no lugar dela.

Como eu uso

A minha base diz quem eu sou, o que eu faço e quais são os meus projetos. Ela também guarda o que eu acredito, os meus valores e o meu estilo de escrita.

Eu converso com a IA no chat do VS Code, dentro do projeto. Ela vai até os aplicativos que aceitam conexão por MCP ou CLI, executa a tarefa lá e me traz pronto.

Se o resultado é uma imagem, ela salva em uma pasta do projeto. Se é um site, eu fico com o arquivo fonte.

Resultado

O que mudou foi o tempo que eu gasto no meu trabalho, de landing pages e SaaS a planejamento e análise de dados.

Um site que normalmente levaria 12 dias ficou pronto em 3.

Em 24 de setembro de 2026, publiquei no GitHub, como template, a mesma estrutura que eu uso. O uso pessoal e profissional é livre, e a venda não é permitida.

O agente de IA continua sendo um serviço à parte, que pode exigir conta ou plano pago.

O projeto me deixou uma base que não depende de uma conta só e um histórico que continua de onde parou.

Ver projeto

Desenvolvimento

2026-09-24

Primeira versão pública, com os dois fluxos de conhecimento, seis skills, as permissões de escrita e a licença CC BY-NC-SA 4.0.

2026-09-25

Versão 0.2.0, com a skill vault-translate e uma explicação do método por trás dos dois fluxos.

2026-10-10

Diagramas de arquitetura e imagem de abertura no README.

Fontes e leituras