Roadmap: os 3 degraus pra usar o Claude Code de verdade no seu negócio

Por que a ordem importa

A maioria das pessoas abre o Claude Code, pede uma coisa solta, recebe uma resposta genérica e conclui que "IA não funciona pro meu negócio". O problema não é a ferramenta, é a ordem dos passos.

Sem estrutura, a IA recomeça do zero em toda conversa. Você repete o contexto da empresa igual papagaio, ela responde no genérico, e em uma semana você desiste. Quem começa "pedindo coisa" quase sempre para por aí.

O caminho que funciona tem três degraus, nessa ordem: fundação, skills e agentes. E o erro clássico é pular direto pro terceiro.

Degrau 1: a fundação (pastas e contexto)

Antes de pedir qualquer coisa, monte a casa. Crie uma pasta por área do seu negócio: marketing, vendas, financeiro, o que fizer sentido pra você.

Dentro de cada pasta, dois arquivos de contexto:

1. Um CLAUDE.md contando o que é a empresa, o que essa área faz, como você escreve e fala. O Claude Code lê o CLAUDE.md da pasta automaticamente, sem você precisar colar nada. Exemplo curto:

# CLAUDE.md (pasta marketing)

Somos a Empresa X, vendemos consultoria financeira pra PMEs.
Esta pasta é da área de marketing.
Tom de voz: direto, sem jargão, sempre em português.
Público: donos de empresa de 10 a 50 funcionários.

2. Um regras.md com o que a IA pode e não pode fazer nessa área:

# regras.md (pasta marketing)

Pode: escrever rascunhos de posts, e-mails e roteiros.
Pode: sugerir pautas com base nos materiais da pasta.
Não pode: publicar nada sozinha.
Não pode: prometer resultado ou citar números que não estão nos arquivos.

Parece simples demais? É justamente por isso que ninguém faz. Mas é esse degrau que muda a resposta de genérica pra "no padrão da empresa".

Degrau 2: as skills (manuais de tarefa)

Skill é um manual de tarefa reutilizável: um arquivo SKILL.md dentro de uma pasta em .claude/skills/nome-da-skill/. Ela ensina a ferramenta a fazer um processo do SEU jeito, sempre igual.

Exemplos de skills que fazem sentido num negócio: "gerar proposta comercial", "responder pedido de orçamento", "resumir reunião em plano de ação".

O esqueleto é assim:

---
name: gerar-proposta
description: Gera proposta comercial no padrão da empresa a partir do briefing do cliente
---

# Gerar proposta comercial

1. Ler o briefing do cliente.
2. Usar o modelo de proposta desta pasta.
3. Preencher escopo, prazo e investimento.
4. Escrever no tom definido no CLAUDE.md.
5. Entregar em arquivo pronto pra revisão.

Criou uma vez, usa pra sempre. Em vez de explicar o processo toda vez, você só chama a skill.

Degrau 3: os agentes

Só depois da fundação e das skills entram os subagentes: arquivos markdown em .claude/agents/, cada um com frontmatter e prompt próprio, que rodam tarefas sozinhos.

Aqui está o pulo do gato: um agente que roda em cima dos degraus 1 e 2 executa com o contexto e o processo da SUA empresa. Um agente criado sem isso improvisa. Ele não conhece seu negócio, não conhece seu processo, e o resultado volta genérico.

O erro clássico

Todo mundo começa pelo degrau 3, porque agente rodando sozinho é o que mais impressiona no vídeo dos outros. Aí o agente improvisa, o resultado sai raso, e a culpa cai na ferramenta.

Quem monta a fundação uma vez para de dar instrução solta e passa a dar ordem de serviço. Essa é a diferença entre brincar com IA e operar com IA.

Crédito e fontes

Tudo que está aqui usa recursos nativos do Claude Code, ferramenta da Anthropic: CLAUDE.md, skills e subagentes são funcionalidades da própria ferramenta (a assinatura ou API do Claude é o custo). Documentação oficial: docs.anthropic.com.