Claude.md, Projects e Skills: o sistema que transforma o Claude em copiloto de produto

Felipe Bedê, AI Product Lead na Afya, mostra como claude.md, Projects e Skills transformam o Claude em um copiloto que conhece você, seu produto e seu time.

11 minutos de leitura

como usar IA sem saber programar

A maioria dos product managers usa o Claude do mesmo jeito toda semana: abre uma nova aba, explica o contexto do zero, recebe uma resposta genérica e passa 20 minutos reescrevendo. Todo dia.

Felipe Bedê, AI Product Lead na Afya, conduziu um workshop de 8 horas com mais de 2.000 PMs demonstrando que o problema não é o Claude, é a ausência de um sistema. Com claude.md, Projects e Skills configurados, o Claude deixa de ser um assistente genérico e vira um copiloto que já sabe quem você é, o que você constrói e como quer receber as respostas.

Este post traz um resumo do que foi construído ao vivo naquele workshop.

O problema não é o Claude, é a falta de contexto

Todo chat novo começa do zero. Sem contexto do produto, sem conhecimento do seu estilo, sem acesso às decisões recentes.

Felipe fez a pergunta certa logo na abertura do workshop: "Quantas vezes por semana você começa um chat explicando o contexto do zero?" A resposta da sala foi unânime: todos os dias, várias vezes.

"O contexto é rei em uma AI. Sem ele, você tem um buscador chique." — Felipe Bedê, workshop Claude para PM’s

A solução não é um prompt melhor. É uma arquitetura de contexto: três camadas que fazem o Claude se comportar como um colega que já trabalha com você há meses.

Claude.md: o arquivo que define tudo

O claude.md é um arquivo em formato Markdown que você escreve uma vez e carrega no Claude. Ele funciona como o manual do usuário da sua relação com a IA: quem você é, como pensa, o que espera das respostas.

Felipe usou uma analogia da animação Ratatouille para explicar o conceito:

"Imagina que você é o Remi, o ratinho, e o Claude é o Linguine. O Remi tem as habilidades culinárias, mas o Linguine precisa do livro , do contexto, para executar. O claude.md é esse livro."

A estrutura dos quatro blocos

O arquivo funciona melhor quando organizado em quatro seções:

Identidade: cargo, empresa, time, papéis secundários. Parece óbvio, mas é o que diferencia uma resposta genérica de uma calibrada para o seu contexto real.

Contexto: o que você constrói, para quem, qual é a métrica principal e quais são os desafios atuais. Três ou quatro frases neste bloco eliminam dez minutos de briefing por conversa.

Estilo: como você quer receber as respostas. Bullets ou narrativa? Nível de detalhe alto ou resumido? No claude.md dele, Felipe incluiu uma instrução direta: "quando eu pedir alguma coisa, só me entregue, não fique fazendo sambaloré antes."

Frameworks e princípios: as metodologias que você usa, as regras inegociáveis de produto, os princípios que guiam as decisões. Com isso, o Claude prioriza da mesma forma que você priorizaria.

Alguns dos princípios de produto que Felipe documenta no próprio arquivo:

  • Pesquise antes de construir, dados são maiores que opiniões;

  • Contexto é rei em uma AI;

  • Sequência importa mais do que escopo.

Como preencher em 10 minutos

Você não precisa escrever o arquivo do zero. Cole o template de claude.md em qualquer IA que você já usa: ChatGPT, Gemini ou o próprio Claude, e peça:

"Preencha as informações desse arquivo com base em tudo que você sabe sobre mim e também sobre as melhores práticas de gestão de produto na internet."

A IA preenche a base a partir do histórico que você já tem com ela. Seu trabalho é revisar e refinar. O arquivo nunca fica "pronto", ele evolui junto com você.

Recomendação técnica: mantenha o arquivo entre 200 e 500 linhas. Acima disso, o modelo começa a perder atenção em partes do contexto, o que Felipe chamou de "intoxicação por contexto".

Projects: onde o contexto vive entre conversas

O claude.md resolve quem você é. O Project resolve onde esse contexto mora de forma persistente.

No Claude, um Project é um espaço de trabalho com memória própria. Você cria um por produto (ou por área da sua vida), arrasta o claude.md para dentro e toda conversa naquele projeto começa com seu contexto já carregado, sem precisar repetir nada.

Para criar: sidebar esquerda → Projetos → Novo projeto → nome e descrição → arraste o claude.md.

Uma boa prática de organização: separe por contexto, não por assunto. Se você trabalha em consultoria, um projeto por cliente. Se você é PM com múltiplos produtos, um projeto por produto. O contexto fica isolado e o Claude não mistura.

Product.md: o contexto do seu produto

O claude.md fala sobre você. O product.md fala sobre o que você constrói.

Felipe demonstrou ao vivo como gerar esse arquivo com um único prompt. Você cola o template de product.md em qualquer IA e pede:

"Utilize esse arquivo como template e pesquise na web todos os dados que você tem sobre meu produto [nome]. Construa a estrutura com possíveis OKRs e métricas. Além disso, coloque o que meus usuários têm falado sobre meu produto no Reclame Aqui e no Reddit."

O resultado é um arquivo com personas, métricas atuais, competidores-chave, reclamações reais de usuários e hipóteses de produto, gerado em minutos e refinado por você. Esse arquivo também entra no Project.

Com claude.md e product.md carregados, o Claude já sabe quem você é e o que você constrói antes de você digitar qualquer coisa.

Skills: especialistas que você chama quando precisa

Se o claude.md é o contexto permanente, as Skills são os especialistas sob demanda.

Uma skill é um arquivo Markdown com instruções especializadas para uma tarefa específica. Você instala no Claude e chama digitando / seguido do nome da skill. A lógica é simples:

"Pensa como uma biblioteca. Você não leva todos os livros para casa — você vai buscar o específico quando precisa." — Felipe Bedê

As seis skills para PMs entregues no workshop

Felipe distribuiu seis skills prontas no workshop, calibradas para o trabalho de produto:

  • PRD Generator: estrutura um PRD completo a partir de um briefing, no formato do seu time.

  • OKR Matrix Analyzer: avalia e prioriza iniciativas contra seus objetivos.

  • Competitive Intel: mapa competitivo com análise de ameaças, oportunidades e estratégia por concorrente.

  • Discovery Analyzer: processa entrevistas, feedbacks e reviews de app store, extrai Jobs to Be Done e hipóteses testáveis.

  • Stakeholder Translator: adapta qualquer decisão ou documento para CEO, engenharia, design e negócio.

  • Executive Brief: resumo executivo de qualquer análise em formato para liderança.

Como instalar e usar

As skills vêm em arquivos .md compactados num .zip. Para instalar: Claude → Personalizar (ou Customizar) → Habilidades → + → fazer upload do arquivo .zip. A documentação oficial da Anthropic sobre Skills detalha como o mecanismo funciona por baixo.

Para chamar: em qualquer conversa, dentro ou fora de um projeto, digite / e o nome da skill. O Claude ativa as instruções daquela skill e processa seu input com essa especialização.

A mágica acontece quando você combina skill com Project: o Claude aplica a skill com o contexto do seu produto e do seu estilo. Em vez de uma análise genérica, você recebe uma análise calibrada para a sua realidade específica.

Artifacts: de prompt a entregável pronto

O Claude não retorna só texto. Com o comando certo, ele gera arquivos que você usa direto: dashboards em HTML, apresentações em PPTX, páginas interativas, wireframes.

Discovery em menos de 5 minutos

Ao chamar o Discovery Analyzer com transcrições de entrevistas em anexo, o Claude processa automaticamente:

  1. Identificação de fontes e codificação por temática

  2. Detecção de contradições entre usuários

  3. Extração de Jobs to Be Done

  4. Geração de hipóteses testáveis com formato "Acreditamos que X pode resultar em Y"

  5. Personas emergentes do conjunto de entrevistas

  6. Priorização das oportunidades identificadas

"Isso demorava no mínimo uma semana para ter todas essas informações. Vocês vão ter em menos de 5 minutos", disse Felipe durante a demonstração ao vivo. O tempo economizado não vai para descanso, vai para o julgamento e curadoria que só o PM faz.

PRD, deck e Slack em uma conversa

Felipe demonstrou o fluxo completo em tempo real:

  1. /prd-generator com briefing da funcionalidade → PRD estruturado com contexto, hipótese, métricas de sucesso e critérios de aceite

  2. /stakeholder-translator → quatro versões do mesmo PRD: uma para CEO, uma para engenharia, uma para design, uma para negócio

  3. Comando deck no chat → apresentação PPTX no formato do template pessoal

  4. Botão "Adicionar ao Google Drive" → publicado direto na nuvem

Tudo em uma única conversa, sem sair do Claude.

O atalho deck não é nativo. Felipe criou dentro do próprio claude.md, junto com outros comandos rápidos como PRDICEanálise e slack. Quando você documenta esses atalhos no seu arquivo, o Claude os interpreta e executa.

Callwork: a automação que roda sem você

O Claude Callwork vai além do chat. É a camada de automação do Claude Desktop: você descreve um fluxo em linguagem natural, agenda quando quer que rode e o Claude executa sozinho.

Durante o workshop, Felipe construiu ao vivo uma automação de ata semanal:

  • Toda sexta-feira às 17h, o Callwork lê a pasta de transcrições da semana

  • Gera um PDF com resumo executivo e decisões principais

  • Move os arquivos processados para a pasta "transcrições usadas"

  • Produz um rascunho de mensagem para o Slack do time

Do prompt ao agendamento: menos de dois minutos.

Limitações importantes: o Callwork funciona apenas no Claude Desktop (não na versão web) e requer plano pago. Para automações de empresa que precisam rodar em servidor, o n8n ainda é o caminho mais robusto.

O fluxo completo: da entrevista ao alinhamento em uma tarde

Com o sistema montado, o que antes levava dias comprime em horas:

  1. Transcrições de entrevistas → Discovery Analyzer → JTBs, hipóteses e priorização em 5 minutos

  2. Hipótese selecionada → PRD Generator → documento estruturado em 20 minutos

  3. PRD → Stakeholder Translator → quatro versões por audiência

  4. Versão executiva → deck → apresentação pronta

  5. Resumo → integração Slack → time alinhado

O PM sai de dados brutos para stakeholders alinhados sem reescrever o mesmo conteúdo quatro vezes.

"Ferramentas de IA não são ferramentas de substituição. São ferramentas de ampliação, para você ficar fazendo coisas que só seres humanos conseguem fazer." — Felipe Bedê

O que fica com você: o julgamento sobre o que priorizar, a leitura do que o usuário realmente quis dizer, a decisão sobre o que construir.

"Esses arquivos: claude.md, product.md, skills, são ativos seus, não do Claude. Você leva para qualquer ferramenta, qualquer empresa." — Felipe Bedê

Próximo passo

Se você ainda está nos primeiros passos, o guia como usar o Claude para product managers cobre a configuração básica de Projects e os quatro workflows essenciais antes de chegar neste nível de sistema.

O que Felipe demonstrou em um workshop de 8 horas cobre uma fração do que um PM com IA bem configurada consegue entregar.

A formação IA Product Managers da Tera aprofunda cada uma dessas camadas, do claude.md ao Callwork, com cases reais e mentores que usam essas ferramentas no trabalho de produto todo dia.

São +35 horas de conteúdo on demand, com exercícios práticos e templates prontos para aplicar no seu produto.

Acesse a formação IA Product Managers

Quer ver o Claude aplicado ao design?

Pós Graduação

No próximo workshop da Tera, Criação com IA, você aprende a usar Claude e Figma juntos para prototipar interfaces, gerar variações visuais e validar ideias com muito mais velocidade.

Garanta sua vaga no workshop Criação com IA

Assine AGORA

Você informado toda semana sobre Produto e IA

Assinar gratuitamente

Integre Claude e Figma de uma vez por todas!

Workshop ao vivo com Juno Jo, embaixador oficial do Figma no Brasil, para designers e PMs que querem integrar Claude e Figma em um fluxo de criação que funciona de verdade.

Garanta sua vaga no

lote promocional