AVEDRAAVDR Guia do mapa

GUIA · PASTA

A sua empresa numa pasta que o Claude Code lê: a estrutura e os modelos

Você comentou PASTA no Reels, então aqui está a estrutura que eu uso, os dois modelos de arquivo prontos para copiar e o passo a passo para montar a sua hoje.

Por Henrique Shimana · 28 de setembro de 2026 · 7 min de leitura

A ideia em uma frase

A IA não conhece a sua empresa; ela lê o que está escrito. Então você escreve uma vez, numa pasta, e o Claude Code lê antes de trabalhar. Sem isso, toda conversa começa do zero e você explica o seu negócio de novo.

1. A estrutura da pasta

Uma pasta por empresa, aberta no Claude Code. Dentro dela, dois tipos de arquivo:

minha-empresa/
  CLAUDE.md o arquivo da empresa (o Claude Code lê sozinho)
  .claude/skills/
    responder-orcamento/SKILL.md um arquivo por tarefa
    escrever-proposta/SKILL.md
    fazer-post/SKILL.md

O CLAUDE.md é lido pelo Claude Code no começo de toda sessão, sem você pedir. Os arquivos de tarefa (as skills) são lidos quando o seu pedido combina com a descrição que está no topo de cada um, ou quando você chama pelo nome.

2. Como começar em 10 minutos

  1. Crie a pasta da empresa e abra o Claude Code dentro dela.
  2. Digite o comando abaixo. Ele escreve o primeiro rascunho do CLAUDE.md olhando o que já tem na pasta (se já existir um, ele sugere melhorias em vez de apagar).
/init
  1. Abra o CLAUDE.md e complete com o modelo da seção 3. O que só você sabe (preço, cliente, tom de voz) a IA não descobre sozinha.
  2. Escolha a tarefa que você mais repete na semana e escreva o primeiro arquivo de tarefa com o modelo da seção 4.

3. Modelo do arquivo da empresa (CLAUDE.md)

Copie, troque o que está entre colchetes e apague o que não serve. A documentação do Claude Code recomenda ficar abaixo de 200 linhas: arquivo curto e específico é seguido com mais consistência.

# [Nome da empresa]

## O que vendemos
- [produto ou serviço 1]: [para que serve], [faixa de preço]
- [produto ou serviço 2]: ...

## Pra quem
- Cliente principal: [quem é, que problema tem, por que compra de nós]
- Quem não é cliente: [o que recusamos]

## Como falamos
- Tom: [ex.: direto, sem jargão, trata por você]
- Palavras que usamos: [...]
- Palavras que não usamos: [...]

## Regras que não mudam
- [ex.: nunca prometer prazo sem confirmar o estoque]
- [ex.: preço só da tabela em precos.md]

## Onde está cada coisa
- Tabela de preço: precos.md
- Modelos de proposta: propostas/

4. Modelo de arquivo de tarefa (SKILL.md)

Escreva como você explicaria para alguém novo no primeiro dia. O bloco de cima (entre as linhas de três traços) diz ao Claude Code quando usar; o resto é o passo a passo. Salve em .claude/skills/escrever-proposta/SKILL.md:

---
name: escrever-proposta
description: Escreve a proposta comercial de um cliente. Use quando eu pedir proposta, orçamento detalhado ou cotação.
---

Antes de começar:
1. Leia o pedido do cliente inteiro.
2. Confira o escopo assinado, se existir.
3. Use só a nossa tabela de preço (precos.md).

Como escrever:
- Abra com o problema do cliente, nas palavras dele.
- Liste o que está incluído e o que não está.
- Feche com prazo, valor final e validade da proposta.

Nunca:
- Inventar desconto.
- Prometer prazo sem eu confirmar.

5. A parte que faz a pasta valer: cada correção vira regra

Quando o Claude Code errar, não corrija só a resposta. Peça:

Corrija e escreva essa regra no arquivo da tarefa, para não acontecer de novo.

É isso que faz a pasta melhorar com o tempo. Aqui na operação, no dia 28 de setembro de 2026, eram 45 funções escritas e 516 lições guardadas, contadas no repositório onde a agência guarda tudo isso.

6. Por que pasta e não mais uma ferramenta

  • É texto simples. Você lê, edita e entende sem programa nenhum.
  • Fica no seu computador. Não depende de uma plataforma continuar existindo.
  • Vai junto se você trocar de IA. Outras ferramentas leem arquivos parecidos (o próprio Claude Code também lê o AGENTS.md, usado por outras ferramentas de código). Você pode precisar renomear ou ajustar, mas o conteúdo, que é o trabalho de verdade, é seu.

Limite

O comportamento do CLAUDE.md, do /init e das skills foi conferido na documentação oficial do Claude Code (code.claude.com/docs) em 28 de setembro de 2026; ferramenta muda, então confira lá antes de depender de um detalhe. O arquivo é contexto, não trava: o Claude Code tende a seguir, mas pode errar, e por isso a revisão continua sendo sua.

GRUPO DO WHATSAPP

Os próximos guias saem primeiro no grupo

É onde eu mando o material novo e respondo dúvida de quem está montando o próprio sistema. Entrar e sair é livre.

Entrar no grupo do WhatsApp