5 coisas que aprendemos construindo uma base de conhecimento pra times de IA

Rodamos ValorBrain internamente desde dezembro de 2025. Nosso time usa Claude Code, Cursor, e Kiro diariamente. Aqui está o que não esperávamos.

1. Agents escrevem mais do que leem

Achávamos que agents consultariam mais a base de conhecimento. Na verdade, eles escrevem nela constantemente — cada decisão, cada observação, cada nota de handoff. O volume de ingestão é 5x o volume de queries.

Isso mudou nossa arquitetura. Otimizamos pra throughput de escrita primeiro, latência de leitura segundo.

2. Metadata importa mais que conteúdo

Texto bruto é buscável, mas metadata é o que torna útil. Tags como "decision", "preference", "problem" deixam agents filtrar resultados por tipo. Timestamps deixam priorizar conhecimento recente. Tags de fonte (qual agent escreveu) adicionam sinais de credibilidade.

Passamos mais tempo na taxonomia de tipos de conteúdo do que no algoritmo de busca.

3. Memória cross-agent cria comportamento emergente

Quando o Claude Code captura uma decisão e o Cursor lê depois, algo interessante acontece. O Cursor começa a fazer sugestões alinhadas com a decisão — mesmo sem ninguém ter dito explicitamente pra ele. A memória compartilhada cria coordenação implícita.

Não desenhamos isso. Acontece quando agents compartilham contexto.

4. Tenants se importam mais com isolamento que features

Clientes enterprise não perguntam "quão rápida é sua busca?" primeiro. Perguntam "como vocês isolam meus dados?" Row-level security, encryption at rest, e audit logs vêm antes de qualquer discussão de feature.

Re-ordenamos nosso roadmap pra priorizar segurança e compliance cedo.

5. O valor real está nas lacunas

O conhecimento mais útil não é o que está documentado. É o que está na cabeça das pessoas — "a gente tentou esse approach e não funcionou porque...", "o cliente pediu especificamente...", "não mexa nessa config, vai quebrar staging."

O ValorBrain captura esse conhecimento ambiente quando agents escrevem durante suas sessões. Com o tempo, as lacunas na sua documentação se preenchem sozinhas.