Nesse primeiro artigo, quero trazer uma nova ótica sobre como trabalhar com inteligência artificial. É comum, quando começamos com IA, que toda a atenção vá para o prompt — o que digitar, como formular, qual a instrução certa. A perspectiva que trago aqui é outra: pensar no ambiente onde esse trabalho acontece.
O modelo e o prompt são ferramentas
Quando você envia uma mensagem no chat do Claude, por trás está rodando um modelo — Opus, Sonnet ou Haiku. Esse modelo processa o que você escreveu e responde.
O prompt e o modelo são instrumentos. Eles não têm contexto sobre você, sobre o seu projeto, sobre como você prefere trabalhar. Cada conversa começa do zero. E me perdoe, leitor, se isso é óbvio para você — mas preciso balizar nosso ponto de partida para sustentar o que vem a seguir.
Você provavelmente já conhece uma forma de contornar isso: fazer upload de um arquivo no chat. A Anthropic suporta PDF, DOCX, CSV, TXT e formatos de imagem — e o Claude consegue ler e analisar o conteúdo. É útil. Mas é contexto pontual: existe naquela conversa e some depois.
A própria Anthropic orienta que um bom prompt deve incluir contexto sobre o que você está trabalhando, instruções de processo e preferências de tom e estilo. São elementos que você repetiria em toda conversa. A ideia da pasta raiz é tirar essas informações do prompt e colocá-las no ambiente — o prompt fica mais curto e direto porque o contexto já está lá.
A perspectiva que trago é sobre algo mais duradouro — tratar essas ferramentas dentro de um ambiente real de trabalho seu. Uma pasta que representa a sua empresa ou o seu projeto. Uma estrutura onde as informações que o Claude precisa já estão descritas antes de você digitar qualquer coisa.
Claude Code — não é só para código
Vou usar o Claude Code como referência ao longo desse artigo. O nome pode enganar: apesar de “Code”, eu o uso diariamente para atividades que não têm nada a ver com programação — escrita, planejamento, processos, documentação. O Claude Cowork também faz algo muito parecido.
O diferencial do Claude Code é justamente esse: ele trabalha dentro de uma pasta no seu computador. Ele lê arquivos. Ele navega pela estrutura que você criou. Ele carrega contexto antes de começar.
Isso transforma o Claude de um chat em um parceiro de trabalho com memória.
A estrutura mínima
Vou apresentar aqui uma estrutura propositalmente simples. O objetivo desse artigo é ser um ponto de partida — algo que você possa testar hoje. Por isso sintetizei os conceitos ao essencial.
Uma pasta raiz que representa o seu projeto ou empresa. Dentro dela, uma pasta de documentação — onde você descreve como o trabalho funciona, o que precisa ser feito, quais são as regras. E uma pasta de resultados — onde o Claude deposita o que produziu para você revisar.
O sistema fica assim: o prompt entra pela pasta raiz. O Claude navega pela documentação para entender o contexto. O resultado aparece na pasta de saída.
Entrada clara. Meio descrito. Saída definida.
Quando você cria um fluxo com esses três elementos, o trabalho começa a se repetir com consistência. Sem explicar do zero toda vez. Sem retrabalho por falta de contexto.
O arquivo que conecta tudo: CLAUDE.md
Para que o Claude entenda essa estrutura, existe uma convenção: um arquivo chamado CLAUDE.md na pasta raiz.
Esse arquivo funciona como uma instrução de entrada. Você escreve nele o que o Claude precisa saber antes de começar qualquer tarefa naquela pasta — o que existe ali, como usar, o que não fazer.
Nas subpastas, o mesmo princípio se aplica. Cada pasta pode ter o seu próprio CLAUDE.md, descrevendo especificamente o que aquela pasta contém e como o Claude deve usar os arquivos dentro dela.
O Claude lê esses arquivos automaticamente quando começa a trabalhar. É como deixar um manual de bordo em cada setor do escritório.
A Anthropic oferece algo parecido na interface web: “project instructions” para comportamento por projeto, uma knowledge base para documentos de referência, uploads para contexto pontual. São ferramentas úteis — mas todas vivem dentro da plataforma.
O CLAUDE.md vive na sua pasta. Portátil, versionável, independente de qualquer interface. A pasta raiz não é uma alternativa ao que a Anthropic oferece — é a versão que você possui. Se você mudar de ferramenta amanhã, o ambiente que construiu continua sendo seu.
A linguagem: Markdown
Os arquivos que o Claude lê melhor são escritos em Markdown. Se você nunca ouviu esse nome, não precisa se preocupar — é uma linguagem de formatação simples, em texto puro, que qualquer editor consegue abrir.
A ideia central: você escreve em Markdown e o Claude entende a estrutura. Títulos, listas, seções — tudo fica acessível para ele navegar.
Não vou me aprofundar aqui sobre como escrever Markdown. Há muita documentação boa na internet. O ponto é: seus arquivos de contexto vivem em Markdown, e o Claude sabe lê-los.
A analogia que meus alunos usam
Quando explico isso nas aulas, sempre surge uma analogia que achei bastante precisa.
É como receber um colaborador novo no seu setor. Você não explica a empresa inteira de uma vez. Você foca na tarefa que ele vai começar a executar agora — o que ele precisa saber, onde ficam os arquivos, o que se espera do resultado.
Com o Claude é a mesma coisa. Você não documenta tudo de uma vez. Você descreve o suficiente para a tarefa atual. E vai expandindo o ambiente conforme o trabalho cresce. Assim como um colaborador, em algum momento ele passa a realizar as atividades sozinho — sem precisar de explicação a cada nova tarefa.
Uma ideia que funciona com qualquer IA
Apesar de ter falado bastante sobre o Claude nesse artigo, a lógica de construir um ambiente não é exclusiva dele. Qualquer IA que consiga ler arquivos e navegar por uma estrutura de pastas se beneficia dessa abordagem.
O que muda entre ferramentas é a convenção de carregamento — como cada uma lê os arquivos de contexto. No Claude Code, é o CLAUDE.md. Em outras ferramentas, pode ser outro mecanismo. A estrutura por trás é a mesma.
Por onde começar
Se você nunca fez isso, minha sugestão é simples: crie uma pasta para um projeto específico. Dentro dela, um CLAUDE.md descrevendo o objetivo desse projeto em poucas linhas. Uma pasta de documentação com as informações que o Claude precisa saber. Uma pasta para os resultados.
Você pode pedir ao Claude Code para criar essa estrutura com o prompt abaixo:
Crie a estrutura mínima de pasta raiz para um projeto
chamado [nome do projeto].
Inclua:
- CLAUDE.md na raiz descrevendo o objetivo do projeto
- Uma pasta documentacao/
- Uma pasta resultados/
No CLAUDE.md, deixe espaço para eu preencher
o objetivo e as regras do projeto.Pense em uma tarefa pequena que você repetiria com frequência. Esse é o teste ideal para essa estrutura.
Nos próximos artigos, vou tornar as coisas um pouco mais complexas — processos, fluxos encadeados, como escalar isso para uma operação real. Espero que esse artigo mude um pouco sua forma de ver a IA e que, ao aplicar a ideia, você colha resultados melhores durante o processo. Fico aqui para ouvir sobre sua experiência.
Se ficar dúvida, estou aqui.
Estou ministrando mentorias para profissionais de diversas áreas que estão começando nessa ideia. Se não quer percorrer esse caminho sozinho, é só me chamar.