Vibecoding
Como preparar seus dados pra IA responder com eles
Jogar a pasta inteira no modelo é caro, lento e piora a resposta. Preparar é separar o que responde pergunta do que é ruído, e isso é trabalho de quem conhece o negócio.
O caminho mais comum pra fazer a IA responder com o conteúdo da empresa é também o pior: joga a pasta inteira e pede pra ela se virar.
Fica caro, fica lento e a resposta piora. Parece contraintuitivo que mais informação piore, mas é o que acontece: conteúdo irrelevante compete com o relevante pela atenção do modelo.
Preparar é curadoria, e é trabalho de quem conhece o negócio.
Passo 1: começa pelas perguntas, não pelos documentos
O erro de origem é partir do que existe.
Parte do que vão perguntar.
Lista as dez perguntas que as pessoas realmente fazem. "Qual o prazo de garantia?" "Como funciona o cancelamento?" "Qual a regra de desconto pra parceiro?"
Agora olha quais documentos respondem essas dez. Quase sempre são poucos, e quase sempre não são os maiores.
Esse conjunto pequeno é o seu ponto de partida. Dá pra crescer depois; é muito mais difícil consertar um conjunto inchado.
Passo 2: quebra em trechos que se sustentam sozinhos
A IA não lê o documento inteiro pra responder. Ela recebe pedaços.
Se o pedaço não faz sentido isolado, a resposta sai pela metade.
O jeito errado: cortar por tamanho fixo. O corte cai no meio de uma frase e separa a pergunta da resposta.
O jeito certo: cortar por seção completa. Uma cláusula inteira, um procedimento inteiro, uma pergunta com a resposta junto.
Teste simples: lê um trecho isolado e pergunta se ele responde alguma coisa sozinho. Se precisar do anterior pra fazer sentido, o corte está errado.
Passo 3: marca origem e data em cada trecho
Dois campos por pedaço, e os dois são obrigatórios.
De onde veio: nome do documento e seção. Permite que a resposta cite a fonte, e resposta com fonte é verificável. Sem isso, a pessoa precisa confiar.
De quando é: a data da versão. Permite descartar o que venceu, que é o próximo passo.
Passo 4: tira o que está vencido
Esse é o que mais melhora resultado e o menos feito.
A pasta tem a política de 2024, a de 2025 e a atual. As três falam do mesmo assunto, com regras diferentes.
A IA encontra a de 2024, acha coerente, responde com ela. Com total segurança, no formato certo, e errado.
E ninguém percebe, porque a resposta parece correta. É o tipo de erro que só aparece quando um cliente cobra uma regra que não existe mais.
Documento vencido é pior que documento ausente. Ausente a IA diz que não sabe; vencido ela responde errado.
O que não entra
Vale tanto quanto o que entra:
Rascunho e versão em discussão. Documento com dado pessoal, a menos que esteja tratado. Ata de reunião, que registra discussão e não decisão. E-mail, salvo quando contém decisão formal.
Material de discussão é especialmente perigoso: a IA encontra a proposta que foi rejeitada e responde como se fosse regra.
Como saber se ficou bom
As dez perguntas do passo 1, de novo. Agora você já sabe as respostas certas.
Roda e compara. Onde errar, pergunta de qual trecho ela tirou aquilo. Ela te diz, e aí você vê se o problema é documento vencido, corte ruim ou conteúdo que falta.
Três rodadas disso resolvem a maior parte.
O que isso tem de estratégico
Esse conjunto curado não é tarefa técnica. É o conhecimento da empresa, escrito, organizado e recuperável.
Ele funciona com o modelo de hoje e com o do ano que vem. Modelo troca; conteúdo bem preparado fica.
É o trabalho que transforma "a gente sabe" em "a empresa sabe".
A decisão é sua.
Perguntas frequentes
Perguntas rápidas
+Por que não entregar todos os documentos?
Porque contexto irrelevante compete com o relevante e piora a resposta, além de custar mais. Um conjunto pequeno e curado responde melhor que uma pasta inteira.
+O que é quebrar em trechos com sentido próprio?
Dividir o documento por seção completa, de modo que cada pedaço se sustente sozinho. Corte por tamanho fixo separa a pergunta da resposta e produz trecho inútil.
+Por que marcar origem e data?
Para a resposta poder citar de onde veio e para você conseguir descartar o que venceu. Sem data, conteúdo antigo é tratado com o mesmo peso do atual.
+Qual o erro mais caro na preparação?
Deixar versão vencida no conjunto. A IA responde com a política antiga, com total segurança, e ninguém percebe porque a resposta parece correta.
Continue lendo
Como decidir onde cada dado do seu sistema vai morar
É a decisão mais cara de mudar depois e a que mais gente deixa a IA tomar sozinha. Quatro perguntas resolvem, e nenhuma delas é técnica.
VibecodingComo apagar código com segurança
Todo projeto tem código que não faz mais nada. Tirar dá medo porque ninguém sabe quem depende daquilo. Existe um caminho de quatro passos que remove o medo.
VibecodingComo escrever comentário que ajuda em vez de atrapalhar
A IA gera comentário que repete o que o código já diz. Isso não é documentação, é ruído. Comentário útil responde uma pergunta que o código não consegue responder.