O início

Minha descoberta pessoal veio por meio de alguns colegas daqui de Mendoza. Um especialista em marketing apresentou a um grupo de CEOs um modelo integrado com o Claude Code, usando o Obsidian.

Eu achei que estava entrando em um encontro onde não iria descobrir nada. Na verdade, quase nem entrei. Estava prestes a desistir, mas algo, meu sexto sentido, me dizia para participar. Desde o primeiro minuto, quando ele apresentou um documento gerado por IA com o objetivo do encontro, eu não entendi nada. Havia outras pessoas e acho que várias também não entenderam nada. Mas também havia outras, digamos duas ou três, que sabiam perfeitamente o que estavam nos mostrando.

À medida que a apresentação avançava, eu interpretava mal o conceito. Fiz algumas perguntas à pessoa que gentilmente estava explicando tudo para nós, mas como não tinha entendido completamente o que ela queria transmitir, minhas perguntas não esclareceram nada e as respostas dela me confundiram um pouco mais.

Ao contrário de outra pessoa que sim entendeu, que contou que tinha o mesmo algo enviado para um repositório e conectado a várias IAs. Essa pessoa estava em outro nível. Claramente.

O que ele nos mostrou foi como montar sua empresa por meio de arquivos, controlados por um curador, um especialista em manter a integridade entre os arquivos. Arquivos com extensão .md (markdown), que é o formato que a IA lê mais facilmente. Lá você define a arquitetura da sua empresa em pastas e arquivos, abrangendo todas as áreas da sua empresa (finanças, marketing, operações, jurídico, RH). Tudo o que sua empresa sabe, tudo o que sua empresa faz, expresso em arquivos de texto organizados.

Cada área tem um arquivo com um formato padronizado, algo assim:

title: Minha anotação / date: 2026-09-13 / tags: [IA, aprendizado] / Título principal / Texto normal em negrito e itálico. / Subtítulo / Lista com marcadores

E é assim que todos os arquivos do seu baú de conhecimento ficam dentro de cada pasta: regras de negócios, manual de marca, perfil nas redes sociais, sua função, seus objetivos, suas responsabilidades. É como ter o cérebro da sua empresa escrito em um lugar onde a IA possa lê-lo, entendê-lo e usá-lo para te ajudar.

Lembro que passei uns dois dias tentando entender o que tinham me mostrado, dei várias voltas, testei várias coisas, até conseguir encontrar o caminho e entender o porquê de tudo o que foi descrito. Entendi que era como ampliar a sua memória — aquela que todos temos na mente — só que, neste caso, a memória ficaria em arquivos no disco rígido do seu notebook, resultando em um espaço de memória praticamente ilimitado.

Uma nova memória

Nós temos isso guardado na nossa memória. Se precisarmos redigir um e-mail, sabemos como fazer. Mas o Claude não sabe como eu redijo e-mails. Então, você cria um arquivo de texto que diga como responder a e-mails: cumprimente, depois faça um resumo do problema em três linhas, em seguida exponha a solução ou o caminho a seguir, e encerre com uma saudação e um "espero que tenha sido útil". Algo assim. Instruções simples. Na verdade, eu poderia copiar e colar dez respostas a e-mails que eu já respondi e usá-las como exemplo. Pronto, com isso vai dar certo.

Baixei um repositório com um esboço de uma empresa genérica que essa mesma pessoa havia criado e que estava disponível no GitHub¹ para quem quisesse baixar, e comecei a trabalhar nele a partir do terminal, com o Claude Code Pro. No começo, me senti perdido, mas, poucas horas depois, já estava organizando pastas, escrevendo arquivos e conversando com o Claude sobre minha própria empresa, como se ele fosse mais um colega.

Em 27 de fevereiro de 2026, desbloqueei um nível de IA. Não estou exagerando ao usar a palavra "desbloqueei". Foi exatamente como em um videogame, quando você passa de nível e novas possibilidades se abrem, possibilidades que antes você nem sabia que existiam.

De repente, tudo o que eu havia aprendido nos anos anteriores fez sentido. Tudo se encaixou. Como vocês podem ver, foi há pouco tempo. Estou há seis meses em uso intensivo e parece que foram quatro anos de progresso. Parece que eu tivesse concluído outro curso na faculdade. Parece que agora, finalmente, estou usando IA para acelerar, ser mais eficiente e competitivo.

É como se tivessem me dado a varinha do Harry Potter, ou como o Neo quando viu a Matrix. E não estou exagerando. Há um antes e um depois daquele 27 de fevereiro.

A ferramenta principal é o Claude Code, que permite usá-lo facilmente a partir de um terminal. Ele foi projetado para criar código-fonte, para programar. O Claude Code possui funções nativas para trabalhar com arquivos, porque os programadores escrevem código em arquivos. Eles fazem isso em diferentes linguagens, mas, no fim das contas, criam arquivos, os mesmos que eu estava preenchendo com informações da empresa.

Pensemos que uma empresa, além de pessoas, é informação. Como as coisas são feitas, o que é vendido para quem, quanto custa cada produto, o que foi decidido em cada reunião, quais regras devem ser seguidas. Tudo isso, mais cedo ou mais tarde, acaba sendo registrado em algum lugar. Um manual, uma planilha, um e-mail, um documento compartilhado.

Se essas informações estiverem em arquivos de texto, o Claude Code pode trabalhar com elas da mesma forma que trabalha com código. Ele pode ler todos os arquivos de uma vez, encontrar o que precisa, cruzar dados que estão em locais diferentes, detectar contradições, atualizar um documento quando algo muda ou criar um novo a partir dos que já existem. O que para um programador é um projeto de software, para uma empresa pode ser sua própria forma de funcionar, organizada em pastas e arquivos.

A diferença é enorme. Não se trata mais de fazer uma pergunta isolada em um chat e copiar a resposta. Trata-se de dar acesso ao conhecimento da empresa para que ele trabalhe diretamente com ele. Além disso, ele vai evoluindo e aprendendo sobre as alterações feitas nos arquivos.

Alguns casos de uso

Um exemplo prático. Pedi ao meu terminal para pesquisar todos os meus concorrentes da Wispro, acessar seus sites e documentação oficial, extrair todas as funcionalidades, elaborar uma tabela comparativa e pesquisar preços.

Em apenas 40 minutos, ele concluiu a tarefa sobre uma dúzia de concorrentes. Eu vinha tentando fazer essa tarefa há anos. Tentei, cheguei a ter informações sobre alguns, mas elas ficaram desatualizadas e nunca mais retomei a tarefa. Era daquelas tarefas que você sabe que precisa fazer, mas sempre há algo mais urgente. Criei um arquivo para cada empresa e guardo todas as informações de cada uma; também elaboro um resumo executivo comparando cada concorrente com as funcionalidades do Wispro, e me deu, além disso, um plano de ação. Hoje posso perguntar a qualquer momento se uma determinada empresa possui ou não uma determinada funcionalidade e ele sabe com exatidão. Antes, responder a essa pergunta poderia me levar muito tempo de pesquisa na internet. Me simplificou algo fácil de fazer mas que levava muito tempo.

Agora, todos os meses, peço ao Claude Code para atualizar as informações, me dizer o que há de novo em cada empresa e manter atualizadas as pastas de cada concorrente.

Outro exemplo em que acabei usando o Claude Code com arquivos e pastas foram as feiras comerciais que acontecem todos os anos em diferentes países da América Latina. O primeiro passo foi fornecer o que já sabíamos: passei a lista das feiras às quais sempre participamos, pedi para ele ampliar o panorama e, a partir dessa lista, solicitei que pesquisasse quais outras feiras do setor acontecem na região. Assim, surgiu um panorama muito mais completo do que o que tínhamos, com opções que antes não estávamos considerando.

Entreguei a ele todas as propostas comerciais que havíamos recebido dos organizadores, com os preços e tipos de estandes, as datas e os locais onde cada feira era realizada. Com essas informações, cada feira deixou de ser apenas um nome e passou a ter um custo, uma época do ano e um local específico. Além disso, consegui montar o calendário completo, com o orçamento de cada uma.

Por fim, vinculei cada feira aos leads que ela gerou no Pipedrive, nosso CRM. Um CRM é o sistema onde uma empresa registra seus clientes e possíveis clientes, e acompanha cada oportunidade de venda desde o primeiro contato até o fechamento. Os leads são exatamente isso: pessoas ou empresas que demonstraram interesse e que podem se tornar clientes.

Quando uma empresa investe em uma feira, ela volta com uma pilha de contatos e uma opinião de se foi bom ou ruim. Agora faço um acompanhamento mensal. Vejo quantas oportunidades cada feira gerou, quantas se converteram em vendas e quanto dinheiro representaram. E como também tenho registrado quanto custou a participação, posso calcular o retorno sobre o investimento de cada uma. O Claude Code criou para mim um site completo, que só consigo abrir no meu navegador, e montou um painel para que eu possa ver as métricas de todas as feiras juntas e de cada uma separadamente. Tudo isso ficou automatizado em poucos dias. Hoje posso pedir para ele atualizar as métricas e, para isso, ele se conecta novamente ao CRM, traz todos os dados atualizados e gera as métricas de novo, tudo em menos de 1 minuto.

Acho que, neste momento, consegui chamar sua atenção. Você está pensando em parar de ler, pegar seu notebook e começar a criar seu Vault para sua empresa ou projeto. Ou também para criar um livro. Foi o que eu fiz: comecei do zero um novo e carreguei nele apenas a estrutura básica de um livro para que não me faltasse nada. Este livro que você está lendo está sendo escrito exatamente assim.

Depois de um mês usando o Claude Code, percebi que todas as pessoas na minha empresa e minha família deveriam começar a usá-lo também.

A primeira pessoa com quem conversei foi meu filho, engenheiro de sistemas. Meu filho é muito mais inteligente do que eu, mas temos tipos diferentes de inteligência. Sempre conversamos sobre trabalho, pois ele trabalha como programador em uma das minhas empresas. A tecnologia sempre foi um tema de conversa entre nós.

Quando ele tinha 15 anos, comprei para ele um PC desmontado e disse: "Monte-o". É claro que ele montou. Lembro que havia um conector que ele conectou errado e precisou pedir ajuda, mas conseguiu resolver sozinho. Ele é daqueles que entendem como o mundo funciona.

No que diz respeito à IA, ele estava muito relutante no começo. Dizia que não adiantava nada, que gerava um código horrível, que ele sempre tinha que ficar consertando bugs. Eu o obriguei a comprar o Claude Code, mas ele o usava como editor de código, como assistente, e continuava sem estar convencido. Quando tivemos essa conversa, ele ainda não usava para o seu dia a dia arquivos de especificações para definir seus projetos.

Então, quando eu contava tudo isso para ele, ele me olhava como se dissesse "e como isso pode me ajudar?". Eu também não soube explicar melhor. Apenas mostrei o caso de uso e como isso me ajudava. Mas isso ficou ali, ressoando, até que ele encontrou o sentido disso para si mesmo; e só então nos alinhamos e ele entendeu o benefício que eu estava obtendo.

O arquivo mestre

O arquivo principal de tudo se chama CLAUDE.md. É lá que ficam todas as instruções por escrito sobre o que queremos do Claude. É o primeiro arquivo que ele lê ao iniciar, e tudo o que acontecer depois depende do que estiver escrito ali.

Meu primeiro CLAUDE.md eu copiei da versão que vinha no repositório. Na verdade, eu não entendia muito bem o que devia ou não escrever. Mas depois fui me aprofundando e foi aí que comecei a definir minhas regras, principalmente com o agente curador, que se encarrega de manter todos os arquivos vinculados e conectados entre si.

Nesse arquivo estão o manual de uso, as regras do jogo, as chaves para nos entendermos. É muito mais simples do que parece. Deve ter menos de 200 linhas de texto, caso contrário, perdemos eficácia. São todas instruções específicas e concretas. Nada ambíguo.

Precisamos fornecer dados da nossa empresa, como nome, setor, tamanho e tudo o que você quiser detalhar. Quanto mais claro você for aqui, melhor funcionará tudo o que vier a seguir. Precisamos especificar o papel do Claude neste projeto. Vamos dizer coisas como "você será o assistente do Leonardo para ajudá-lo a desenvolver seu plano de expansão na América Latina". Vamos definir o tom e a forma como queremos que ele responda.

Vamos indicar como está organizada a estrutura de pastas e arquivos para que ele sempre encontre tudo rapidamente.

É preciso sempre ter cuidado e não tentar fazer tudo de uma vez só. Na IA, você precisa dividir tudo em pequenas tarefas e realizá-las uma de cada vez. No início, sempre é melhor fazer um pequeno teste de uma parte e ver se é o que você queria. Se não for, você corrige e repete o processo até que o resultado seja o desejado. Não tenha pressa. A IA vai rápido demais e tende a se perder no caminho.

Uma estrutura que recomendo é mais ou menos assim. Dentro do CLAUDE.md, indicamos que ele leia knowledge/empresa.md e knowledge/equipe.md. São dois arquivos dentro de uma pasta chamada "knowledge". Lá, explico muito mais sobre a empresa e a equipe, no que nos dedicamos, o que vendemos, onde e por quê. Descrevo em detalhes quantas pessoas trabalham, quem são e o que fazem.

Se amanhã uma nova pessoa entrar na empresa, ela deveria poder ler esses arquivos e entender do que se trata o negócio. Essa é a prova de que estão bem escritos.

Também posso carregar nele os agentes e suas habilidades: para que servem, quais serão suas tarefas e como elas serão realizadas. Defino para ele as regras de negócio, como o horário de atendimento ser das 9h às 18h ou que os preços sempre incluem impostos ou não. Tudo o que for uma regra fixa vai para cá.

Vamos detalhar tudo o que ele tem proibido de fazer. Por exemplo, quebrar alguma das regras previamente definidas ou inventar outras que não existam. Nos meus projetos, proíbo-o, por exemplo, de usar meus pensamentos. Eu armazeno esporadicamente o que penso e quero guardar. Guardo-os em um arquivo numerado. Lá coloco o que penso sobre tudo, sem rodeios. Portanto, tenho uma regra de que é proibido usá-los ou mencioná-los. É como uma chave de segurança, e o Claude não tem essa chave.

Vocês apenas escrevem texto, mas esse texto é lido pelo Claude Code toda vez que ele é executado. A primeira coisa que ele faz é ler essas regras e, a partir daí, nunca sai do contexto. É isso que o diferencia de uma conversa informal no ChatGPT: aqui há estrutura, há memória, há regras.

O segredo é escrever como se você estivesse explicando para uma pessoa nova que entra para trabalhar na sua empresa. O que você diria a ela? O que ela precisaria saber para fazer bem o trabalho? Bem, tudo isso vai para esses arquivos. A diferença é que essa pessoa nova nunca esquece de nada.

Já temos essa nova pessoa na empresa. Ela trabalha 24 horas por dia e, se você pedir algo às três da manhã, ela faz com a mesma qualidade que às dez.

Além disso, vocês vão atualizar isso todos os dias. Se quiserem pedir para ela mudar o tom das sugestões, basta atualizar esse arquivo e pronto. Se as regras do negócio mudarem, atualizem o arquivo. Se incorporarem uma nova pessoa à equipe, basta adicioná-la ao arquivo. O sistema é dinâmico e evolui junto com a sua empresa. Basta escrever no terminal que mudança você quer fazer e nada mais.

Depois de ter explicado tudo isso a ele, meu filho olhou para mim e disse: "Sim, já entendi. Mas não como você, pensado para uma empresa. Eu uso isso para controlar meu ambiente de desenvolvimento." O que ele usava para programar, eu estava usando para organizar meu trabalho na empresa.

1. GitHub. Plataforma de desenvolvimento colaborativo fundada em 2008 que permite hospedar, compartilhar e versionar código e arquivos usando Git. Propriedade da Microsoft desde 2018. https://github.com ↩