Pular para o conteúdo

Sistemas com IA

Como dar contexto para IA: o cérebro da empresa em pastas e arquivos

Como dar contexto para IA com o cérebro da empresa: pastas e arquivos com negócio, voz e regras, CLAUDE.md, AGENTS.md e o passo a passo para montar.

· Designer de landing pages e fundadora da Fysi Lab Digital

· 12 min de leitura

Fundo abstrato azul-petróleo com luz suave
Neste artigo
  1. O que é dar contexto para a IA
  2. O cérebro da empresa: a pasta que a IA lê antes de trabalhar
  3. CLAUDE.md e AGENTS.md: os dois arquivos de entrada
  4. As regras de trabalho que vão no AGENTS.md
  5. Como montar o cérebro da sua empresa, passo a passo
  6. O que muda no dia a dia com o contexto certo
  7. Como manter o cérebro atualizado
  8. O que eu ajusto quando a IA erra o contexto
  9. Perguntas frequentes
  10. Monte o contexto antes do sistema

Para saber como dar contexto para IA de um jeito que dure, troque o prompt comprido que você cola em toda conversa por uma pasta de arquivos que a IA lê antes de trabalhar. Nessa pasta ficam quem é a empresa, para quem ela vende, como ela fala, quem decide o quê e quais regras não podem ser quebradas. Eu chamo essa pasta de cérebro da empresa. Com ela, cada conversa começa do mesmo ponto, e o texto que sai já vem com a sua voz.

A Fysi Lab Digital tem o seu cérebro, e é por ele que eu começo o Sistemas Sob Medida, antes de qualquer sistema. Eu decidi essa ordem depois de ver a mesma cena se repetir: sistema bonito, construído rápido, com textos e regras que não pareciam da empresa. O contexto vem primeiro. Neste guia eu abro o cérebro da Fysi por dentro, arquivo por arquivo, e mostro como montar o seu. O caminho inteiro, do cérebro ao sistema publicado, está no guia de sistemas com IA.

O que é dar contexto para a IA

Contexto é tudo o que a IA precisa saber sobre você para acertar o trabalho na primeira tentativa. Quando você pede "escreve uma proposta", a IA escreve uma proposta média, de uma empresa média. Quando ela sabe que você atende escritórios de advocacia, que a sua proposta começa pelo diagnóstico, que você nunca usa emoji e que preço só aparece depois das fases, a proposta sai parecida com a que você mandaria.

Existem três jeitos de dar esse contexto, e eles se somam:

  • No pedido: o que você escreve na conversa. Serve para a tarefa do momento.
  • Num projeto do chat: arquivos e instruções que ficam guardados num projeto do Claude. Serve para um assunto que se repete.
  • Numa pasta no computador: o cérebro da empresa, lido pelo Claude Code ou pelo Claude Desktop sempre que você abre a pasta. Serve para o negócio inteiro.

Eu uso os três, e o terceiro é a base dos outros dois. Ele é o único que cresce junto com a empresa, porque cada decisão nova vira uma linha num arquivo.

O cérebro da empresa: a pasta que a IA lê antes de trabalhar

O cérebro da empresa é uma pasta comum, com arquivos de texto em Markdown. Ele funciona como o manual que você entregaria para uma pessoa nova no time, com uma diferença: a IA lê esse manual inteiro toda vez, e não esquece nada no caminho.

Na Fysi, o cérebro tem esta estrutura:

Arquivo ou pastaO que guarda
AGENTS.mdA visão geral da empresa num parágrafo, as regras de trabalho e o mapa dos outros arquivos
CLAUDE.mdUma linha só, mandando ler o AGENTS.md
contexto/EMPRESA.mdO que a empresa vende, para quem, o posicionamento e o momento atual
contexto/TIME.mdQuem trabalha, o papel de cada um e quem decide o quê
contexto/VOZ.mdComo a empresa fala: tom, palavras que usa, palavras proibidas, exemplos de "assim sim" e "assim não"
contexto/DIFERENCIAIS.mdPor que escolher a empresa, cada diferencial com a prova que o sustenta
contexto/DESIGN.mdCores, fontes, uso do logo e o que nunca fazer
contexto/ativos/Os arquivos da marca: logos, fotos, fontes e modelos
operacao/<área>/O trabalho que sai, por área: comercial, marketing, gestão, cursos

A divisão entre contexto e operação é a decisão mais importante dessa estrutura. Contexto é o que a empresa é, e muda pouco. Operação é o que a empresa produz, e muda todo dia. Quando a IA escreve um carrossel, ela lê o contexto e grava o resultado em operação. Na próxima vez, ela encontra o carrossel anterior e reaproveita o que já foi decidido.

CLAUDE.md e AGENTS.md: os dois arquivos de entrada

Os dois são arquivos de instrução que as ferramentas de IA procuram na raiz da pasta.

O CLAUDE.md é o arquivo que o Claude Code lê no começo de cada sessão. A documentação oficial descreve o CLAUDE.md como arquivos em Markdown que dão ao Claude instruções persistentes para um projeto, e recomenda tratá-lo como o lugar onde você escreve o que, de outro jeito, teria de explicar de novo (documentação do Claude Code sobre memória, consultada em 20/11/2026).

O AGENTS.md é um formato aberto para orientar agentes de programação, descrito pelos próprios autores como um README para agentes (agents.md, consultado em 20/11/2026). Outras ferramentas de IA também leem esse arquivo.

No cérebro da Fysi, o conteúdo inteiro fica no AGENTS.md, e o CLAUDE.md tem uma linha: leia o AGENTS.md na raiz, ele é a fonte de verdade sobre esta empresa. Eu escolhi assim para o cérebro funcionar em mais de uma ferramenta. Se um dia eu trocar de IA, o contexto vai junto, sem reescrever nada.

As regras de trabalho que vão no AGENTS.md

Contexto sem regra vira inspiração. A IA lê que você atende clínicas e mesmo assim inventa um depoimento de paciente, porque ninguém disse que isso é proibido. As regras de trabalho fecham essa porta. No cérebro da Fysi, elas são seis:

  1. Todo conteúdo passa pelo arquivo de voz antes de ser entregue. Post, proposta, e-mail, página e mensagem interna.
  2. Dado que não está na pasta ou na conversa fica de fora. Nome de cliente, número, prazo e preço só entram se estiverem escritos. Quando faltam, a IA escreve "> A definir" ou pergunta.
  3. Quando falta contexto, a IA pergunta, uma pergunta por vez. Uma pergunta custa menos do que uma entrega errada.
  4. Trabalho que sai vira arquivo na pasta da área, com nome claro e data.
  5. Antes de criar algo novo, a IA procura o que já existe e reaproveita.
  6. Fato novo e durável sobre a empresa vira atualização do contexto. A IA oferece a mudança no arquivo certo.

A regra 2 é a que mais protege a marca. O marcador "> A definir" deixa o buraco visível. Você abre o arquivo e vê exatamente o que ainda falta decidir. O palpite da IA fica fora do texto, onde ele não engana ninguém.

A regra 6 é a que mantém o cérebro vivo: a empresa muda, e a pasta muda junto.

Como montar o cérebro da sua empresa, passo a passo

O cérebro sai de uma entrevista. A IA pergunta, você responde, e ela grava os arquivos. Este é o caminho que eu ensino.

1. Crie uma pasta vazia e abra no Claude

Uma pasta no computador, com um nome claro, como "cerebro-empresa". Abra essa pasta no Claude Code, no Cursor com o Claude ou no Claude Desktop. Na aula, eu faço pelo Cursor, que mostra os arquivos sendo criados ao lado da conversa.

2. Cole o prompt de entrevista

O prompt diz à IA o que montar e como conduzir. Os pontos que não podem faltar: uma pergunta por vez; pedir exemplo concreto quando a resposta vier vaga; nunca inventar dado; mostrar um resumo de cada bloco e pedir confirmação antes de gravar o arquivo; apontar quando algo contradiz o que já foi registrado.

3. Responda a entrevista em blocos

A entrevista que eu uso tem seis blocos: empresa, time, voz, diferenciais, identidade visual e operação. Cada bloco vira um arquivo. As perguntas começam simples. Qual é o nome da empresa? Numa frase, sem jargão, o que ela entrega? Para quem vocês vendem?

Responda com detalhe. "Atendo pequenas empresas" gera um arquivo genérico. "Atendo donos de escritório e clínica que já faturam bem, têm autoridade fora das redes e posicionamento fraco no digital" gera um arquivo que muda o texto da IA. Quanto mais específica a resposta, melhor o cérebro.

4. Dê atenção dobrada ao bloco de voz

Entregue de três a cinco textos seus de que você gosta: posts, e-mails, mensagens para cliente. Peça para a IA analisar o padrão e escrever as regras: tom, ritmo, palavras que você usa, palavras que nunca usaria. Depois revise linha por linha. O arquivo de voz é o que faz o texto da IA soar como você, e ele só fica bom com exemplo verdadeiro. Os exemplos inventados que a IA sugere no começo saem assim que você tiver os seus.

5. Liste as áreas e as tarefas que se repetem

No bloco de operação, diga quais áreas existem no seu negócio e o que se repete toda semana em cada uma. Essa lista cria as pastas de operação e, de quebra, vira a matéria-prima do diagnóstico de sistemas. A tarefa que se repete toda semana é a candidata natural ao primeiro sistema.

6. Confira o AGENTS.md e teste

Abra o AGENTS.md e leia como se fosse a pessoa nova no time. Depois faça um teste: peça um post, uma resposta para um cliente e uma proposta. Compare com o que você escreveria. O que estiver fora do tom aponta o arquivo que precisa de mais detalhe.

O que muda no dia a dia com o contexto certo

A diferença aparece no primeiro texto. Proposta, post e página saem com a voz da empresa, porque a IA leu o arquivo de voz antes de escrever. O meu tempo deixou de ir para corrigir tom e passou a ir para decidir conteúdo.

Nos sistemas, o ganho é maior. Quando eu abro o Claude Code para construir, ele já sabe como a Fysi vende, quem usa cada sistema e quais palavras aparecem na tela. O PRD fica mais curto, porque metade do contexto já está na pasta. Essa é a razão de o cérebro vir antes de qualquer sistema no curso.

Para a equipe, o cérebro resolve outro problema. Cada pessoa que usa IA com o próprio prompt recebe um resultado diferente. Com a mesma pasta, todo mundo parte do mesmo contexto. Como levar isso para o time inteiro, com os planos e os cuidados de cada um, eu explico em Claude para empresas.

Como manter o cérebro atualizado

O cérebro envelhece quando a empresa muda e a pasta fica parada. Três hábitos resolvem:

  • Atualize na hora. Mudou um preço, entrou uma pessoa no time, saiu um serviço: a IA oferece a atualização pela regra 6, e você aceita ali mesmo.
  • Revise os "> A definir". Uma vez por mês, procure os marcadores e preencha o que você já decidiu.
  • Registre as decisões. Uma pasta de gestão com um registro de decisões evita que a mesma discussão volte toda semana.

Com o tempo, o cérebro ganha ferramentas por cima. Uma skill transforma uma tarefa repetida num atalho, e um conector deixa a IA ler a agenda ou o Drive. As duas coisas funcionam melhor quando o contexto já existe, e eu trato delas em outros guias. Para começar, a pasta basta.

O que eu ajusto quando a IA erra o contexto

  • Escrever o contexto uma vez e esquecer. Pasta parada ensina à IA uma empresa que já mudou.
  • Colocar tudo num arquivo só. Um documento gigante mistura voz, preço e processo. Arquivos separados deixam a IA ler o que importa para cada tarefa e deixam você achar o que precisa corrigir.
  • Usar adjetivo no lugar de fato. "Atendimento de excelência" serve para qualquer empresa. "Respondemos no mesmo dia útil" é uma regra que a IA consegue seguir.
  • Deixar a IA preencher o que você não sabe. Dado inventado no contexto vira dado inventado em todo texto que sai dali.
  • Guardar senha e dado sensível na pasta. Contexto é sobre o negócio. Chave de acesso, senha e dado pessoal de cliente ficam fora dela.

Perguntas frequentes

Como dar contexto para o Claude?

Para uma tarefa, escreva o contexto no pedido. Para um assunto que se repete, use um projeto no Claude com arquivos e instruções. Para o negócio inteiro, monte uma pasta com CLAUDE.md, AGENTS.md e os arquivos de contexto, e abra essa pasta no Claude Code ou no Claude Desktop.

Qual a diferença entre CLAUDE.md e AGENTS.md?

O CLAUDE.md é o arquivo de instruções que o Claude Code lê. O AGENTS.md é um formato aberto lido por várias ferramentas de IA. No meu cérebro, o conteúdo fica no AGENTS.md e o CLAUDE.md só aponta para ele, para o contexto funcionar em mais de uma ferramenta.

Preciso saber programar para montar o cérebro da empresa?

Você precisa saber explicar o seu negócio. A pasta é feita de arquivos de texto, e a IA cria a estrutura enquanto entrevista você.

O cérebro da empresa funciona no ChatGPT?

Os arquivos são texto comum, então você consegue levar o conteúdo para outra ferramenta. A leitura automática da pasta, a cada sessão, depende da ferramenta que você usa. Eu comparo as duas mais buscadas em Claude ou ChatGPT.

É seguro colocar os dados da empresa na pasta?

Coloque o que você colocaria num manual para um funcionário novo: oferta, processo, voz, decisões. Deixe fora senha, chave de acesso e dado pessoal de cliente. E confira as regras de uso de dados do plano da IA que você usa.

Monte o contexto antes do sistema

No Sistemas Sob Medida, eu começo pelo cérebro da empresa e sigo, na ordem, até o sistema publicado: diagnóstico, PRD, construção com o Claude, segurança e publicação. O caminho completo está em como criar sistemas para o seu negócio com IA. Se você prefere que uma equipe organize e construa os sistemas da sua empresa, a Fysi Lab Digital faz para você.

Continue lendo

Ver todos os posts

Sistemas Sob MedidaConstrua o sistema do seu negócio
Quero construir

Quero contratar

O que você precisa?