product-marketing-context

Visão geral da skill product-marketing-context

O que a product-marketing-context faz

A skill product-marketing-context ajuda você a criar e manter um arquivo-base compartilhado de product marketing em .agents/product-marketing-context.md. A proposta é simples, mas muito útil: registrar uma vez a visão geral do produto, público, posicionamento, objeções, provas, e fundamentos de mensagem para que outros fluxos de marketing reutilizem esse contexto, em vez de refazer as mesmas perguntas básicas toda vez.

Para quem essa skill é indicada

Ela é mais indicada para founders, product marketers, líderes de growth e agências que precisam de trabalho de marketing com IA de forma repetível em um repo ou projeto de cliente. É especialmente útil se você busca mais consistência em tarefas de mensagem como posicionamento, definição de ICP, rascunhos de landing pages, planejamento de campanhas ou conteúdos de sales enablement.

O verdadeiro trabalho que ela resolve

A maioria das equipes não precisa de “mais copy”. Precisa de uma camada estável de contexto que o modelo possa consultar antes de escrever qualquer coisa. A product-marketing-context skill foi feita para essa etapa de preparação. Primeiro ela cria um documento reutilizável de contexto de marketing; depois, outras skills podem trabalhar a partir dele.

Por que isso é melhor do que um prompt genérico

Um prompt comum pode pedir posicionamento, mas normalmente gera uma resposta pontual, para aquele momento. A product-marketing-context é estruturada para:

• verificar primeiro se já existe um arquivo de contexto
• atualizar apenas as seções que mudaram
• oferecer um rascunho automático a partir do codebase ou um fluxo guiado começando do zero
• salvar o resultado em um caminho de arquivo previsível, que outras skills podem consultar

Isso torna a solução mais operacional do que um prompt genérico do tipo “me ajuda com messaging”.

Casos em que faz sentido — e em que não faz

Melhor encaixe:

• produtos novos que ainda não têm uma base de messaging
• repos em que várias skills de marketing com IA serão usadas
• equipes atualizando posicionamento após um lançamento, mudança de preço ou mudança de público

Encaixe fraco:

• tarefas pontuais de copy em que você não quer contexto persistente
• produtos sem repo acessível ou materiais de produto para analisar
• equipes esperando que a skill, sozinha, faça pesquisa de mercado profunda

Como usar a skill product-marketing-context

Contexto de instalação e onde o arquivo fica

Se o seu ambiente oferece suporte à instalação de Skills, adicione o repositório pai e use a skill product-marketing-context a partir dele. O arquivo de saída em torno do qual essa skill foi construída é:

/.agents/product-marketing-context.md

A skill também verifica .claude/product-marketing-context.md em configurações antigas e pode ajudar a migrar esse conteúdo.

Comece verificando se já existe um arquivo de contexto

Antes de criar qualquer coisa nova, o fluxo esperado é procurar por:

• .agents/product-marketing-context.md
• .claude/product-marketing-context.md

Se já existir um arquivo de contexto, o movimento certo não é “reescrever tudo”. Leia o arquivo, resuma o que já está documentado e atualize somente as seções impactadas pelas mudanças do usuário.

Escolha o caminho de configuração certo

O repositório mostra dois caminhos práticos de entrada:

1. Auto-draft a partir do codebase
   Recomendado quando o repo tem sinais úteis, como README.md, copy da landing page, docs, package.json ou textos do produto dentro do app.

2. Começar do zero
   Melhor quando o repo é enxuto, materiais privados importam mais do que o código, ou o produto ainda está sendo definido.

Esse é um dos pontos mais importantes de adoção no product-marketing-context guide: os resultados melhoram bastante quando você escolhe o caminho de acordo com a qualidade das evidências disponíveis.

Quais inputs a product-marketing-context precisa

Para gerar uma saída útil, forneça pelo menos:

• o que é o produto
• para quem ele é
• qual problema principal ele resolve
• como ele se diferencia das alternativas
• quaisquer provas atuais ou restrições
• se isso é um primeiro rascunho ou uma atualização

Inputs extras úteis:

• mudanças de pricing tier
• novas personas
• padrões de win/loss
• linguagem de clientes extraída de calls ou reviews
• preferências de brand voice
• objeções de vendas
• metas de lançamento ou do trimestre

As seções que essa skill tenta construir

Com base nos evals e no fluxo do repositório, espere que o uso de product-marketing-context cubra seções como:

• Product Overview
• Target Audience
• Personas
• Problems You Solve
• Competitive Landscape
• Differentiation
• Objections
• Switching Dynamics
• Customer Language
• Brand Voice
• Proof Points
• Goals

Essa estrutura importa porque cria um arquivo de contexto durável, e não apenas um parágrafo de posicionamento.

Como transformar um pedido vago em um prompt forte

Fraco:

Help me with product marketing.

Melhor:

Use the product-marketing-context skill. Check whether .agents/product-marketing-context.md already exists. If not, auto-draft a V1 from the repo and website copy. Capture product overview, ICP, personas, key pain points, differentiation, objections, proof points, customer language, and brand voice. Flag assumptions clearly so I can review them.

Melhor ainda para atualizações:

Use the product-marketing-context skill to update our existing context. We added an enterprise tier and now sell to VP of Engineering in addition to Product Managers. Read .agents/product-marketing-context.md, tell me which sections need revision, then update only those sections and preserve everything still valid.

Um workflow prático que reduz achismo

Uma boa sequência de trabalho é:

1. Verificar se já existe um arquivo de contexto.
2. Decidir entre auto-draft e entrevista guiada.
3. Construir ou atualizar o arquivo de contexto seção por seção.
4. Marcar suposições e evidências ausentes.
5. Revisar com o usuário para corrigir o que for necessário.
6. Salvar em .agents/product-marketing-context.md.
7. Reutilizar esse arquivo em tarefas futuras de marketing.

Esse é o principal motivo para fazer um product-marketing-context install cedo no projeto: ele reduz trabalho repetido de setup depois.

Leia primeiro estes arquivos do repositório

Para uma avaliação rápida, comece por:

• skills/product-marketing-context/SKILL.md
• skills/product-marketing-context/evals/evals.json

O SKILL.md explica o fluxo operacional. Já evals/evals.json é útil porque mostra como é um “uso correto” em prompts realistas, incluindo atualizações após mudanças no produto.

O que melhora de forma material a qualidade da saída

As melhores saídas vêm de evidência, não de aspiração. Se você quer um documento de contexto mais forte, direcione a skill para:

• copy da homepage ou landing page
• docs do produto e textos de onboarding
• notas de transcrição de demos
• descrições de pricing e planos
• citações de entrevistas com clientes
• comparativos com concorrentes que vocês realmente usam
• objeções levantadas em sales calls
• brand guidelines já existentes

Sem isso, o rascunho ainda pode ser útil, mas vai trazer mais suposições genéricas.

O que esperar do primeiro rascunho

Uma V1 criada com product-marketing-context deve ser tratada como documento de trabalho, não como verdade final. O rascunho mais útil:

• separa fatos confirmados de posicionamentos inferidos
• expõe lacunas em proof points ou na clareza sobre o público
• oferece estrutura suficiente para que tarefas posteriores de marketing com IA mantenham consistência

Se você quer messaging estratégico já lapidado, espere fazer ao menos uma rodada de revisão depois que o arquivo inicial for criado.

FAQ da skill product-marketing-context

A product-marketing-context é boa para iniciantes?

Sim. Ela é amigável para iniciantes porque o fluxo é explícito: verificar se já existe um arquivo, escolher entre auto-draft ou configuração guiada e então preencher seções específicas. Você não precisa dominar frameworks formais de PMM para obter uma primeira versão útil.

Quando devo usar product-marketing-context em vez de um prompt normal?

Use quando quiser contexto reutilizável em várias tarefas. Se o objetivo é um único headline de landing page, um prompt normal pode bastar. Se o objetivo é manter consistência de mensagem em muitos outputs, product-marketing-context for Product Marketing é uma base melhor.

Ela consegue atualizar um contexto existente em vez de recriá-lo?

Sim. Esse é um comportamento central da skill. Ela foi projetada para ler um .agents/product-marketing-context.md existente, resumir o que já está lá e revisar apenas as seções afetadas por novas informações.

Ela faz pesquisa de mercado por mim?

Não exatamente. Ela consegue inferir bastante coisa a partir do repo e dos materiais do produto, mas não substitui pesquisa com clientes. Se suas evidências forem fracas, a saída será estruturalmente útil, porém estrategicamente mais superficial.

E se meu repo tiver pouquíssima copy de marketing?

Use o caminho de começar do zero e responda às perguntas de forma conversacional. Em muitos casos, isso é melhor do que forçar um auto-draft em codebases enxutos que revelam pouco sobre clientes, objeções ou contexto de compra.

A product-marketing-context só é útil dentro deste ecossistema de repos?

Ela entrega mais valor quando é usada junto com outras skills de marketing que consultam .agents/product-marketing-context.md, mas o arquivo em si é portátil. Você ainda pode usá-lo como seu briefing canônico de PMM mesmo fora do ecossistema completo de skills.

Quando essa skill é uma escolha ruim?

Evite se:

• você só precisa de uma única peça isolada de copy
• sua equipe não vai manter um arquivo de contexto compartilhado
• seu produto ainda está indefinido demais para responder perguntas básicas sobre público e problema

Como melhorar a skill product-marketing-context

Dê evidências para a skill, não apenas objetivos

O maior salto de qualidade na product-marketing-context skill vem de materiais-fonte melhores. “Queremos um posicionamento mais forte” não basta. Forneça insumos brutos como:

• texto da homepage
• notas de calls com clientes
• principais objeções vindas de sales
• motivos pelos quais clientes trocam de solução
• explicações de feature para benefício
• proof points com números

Isso permite que o modelo ancore as afirmações em dados, em vez de inventá-las.

Seja explícito sobre o que mudou

Para atualizações, não peça uma revisão ampla se só duas coisas mudaram. Diga exatamente o que é novo:

• novo pricing tier
• ICP expandido
• categoria renomeada
• foco maior em enterprise
• nova pressão competitiva

Isso ajuda a skill a atualizar as seções certas sem enfraquecer, por acidente, mensagens que continuam corretas.

Peça para as suposições serem rotuladas

Um modo de falha comum é o achismo escondido. Para melhorar a qualidade da saída, peça que o modelo marque:

• fatos confirmados
• inferências prováveis
• inputs ausentes
• perguntas para revisão

Isso torna o primeiro rascunho muito mais fácil de aprovar e refinar.

Faça revisão seção por seção para um resultado final melhor

Não deixe para revisar o documento inteiro só no final. As seções de maior valor para validar logo no começo são:

• Target Audience
• Problems You Solve
• Differentiation
• Objections
• Proof Points

Se essas partes estiverem erradas, todo o messaging construído depois a partir do arquivo também vai se desalinhar.

Reforce a captura da linguagem do cliente

Um ponto fraco recorrente é a linguagem genérica. Para melhorar o product-marketing-context guide na prática, alimente a skill com frases reais que os clientes usam em:

• entrevistas
• tickets de suporte
• sites de review
• calls de vendas
• feedback de onboarding

A linguagem real do cliente melhora muito a relevância das copies geradas depois.

Fique atento a estes modos de falha comuns

Problemas típicos incluem:

• listas de features disfarçadas de posicionamento
• ICPs amplos demais
• diferenciação fraca contra “concorrentes” vagos
• brand voice aspiracional sem exemplos
• proof points que são alegações, não evidências

Se você identificar isso, revise os inputs de origem antes de pedir uma reescrita.

Itere com prompts de follow-up específicos

Depois do primeiro rascunho, use prompts focados como:

• “Narrow the ICP to the most likely first buyer.”
• “Rewrite objections based on enterprise procurement concerns.”
• “Separate direct competitors from status-quo alternatives.”
• “Turn proof points into evidence-backed bullets only.”

Uma iteração direcionada melhora o documento muito mais rápido do que pedir uma reescrita completa.

Mantenha a product-marketing-context como um arquivo vivo

O melhor uso de longo prazo da product-marketing-context é manutenção contínua, não setup único. Revise o arquivo quando seu produto, público, pricing, categoria ou motion comercial mudar. Assim, toda tarefa de marketing downstream continua alinhada com a realidade atual, e não com suposições desatualizadas.