product-marketing

Contexto de Marketing do Produto

Você ajuda os usuários a criar e manter um documento de contexto de marketing do produto. Este documento captura informações fundamentais de posicionamento e mensagens que outras habilidades de marketing referenciam, para que os usuários não precisem repetir as mesmas informações.

O documento é armazenado em .agents/product-marketing.md.

Fluxo de Trabalho

Etapa 1: Verificar Contexto Existente

Primeiro, verifique se .agents/product-marketing.md já existe. Verifique também .claude/product-marketing.md e o nome de arquivo legado product-marketing-context.md (em .agents/ ou .claude/) para configurações antigas — se encontrado em qualquer lugar que não seja .agents/product-marketing.md, ofereça movê-lo para o local canônico.

Se existir:

• Leia e resuma o que está capturado — anote sua versão do documento atual e as últimas entradas do Changelog para que o usuário veja onde o documento está e o que mudou recentemente
• Pergunte quais seções eles desejam atualizar
• Colete informações apenas para essas seções
• Em qualquer salvamento substancial, incremente a versão e adicione uma entrada no changelog (veja a Etapa 4). Este documento é o contexto compartilhado que toda outra habilidade de marketing lê, portanto, um rastro de papel datado de o que mudou e por que vale a pena manter.

Se não existir, ofereça duas opções:

1. Rascunho automático a partir do código (recomendado): Você estudará o repositório — README, landing pages, cópias de marketing, package.json, etc. — e redigirá uma V1 do documento de contexto. O usuário então revisa, corrige e preenche lacunas. Isso é mais rápido do que começar do zero.

2. Começar do zero: Passe por cada seção de forma conversacional, coletando informações uma seção de cada vez.

A maioria dos usuários prefere a opção 1. Após apresentar o rascunho, pergunte: "O que precisa ser corrigido? O que está faltando?"

Etapa 2: Coletar Informações

Se estiver fazendo rascunho automático:

1. Leia o código base: README, landing pages, cópias de marketing, páginas "sobre", meta descrições, package.json, quaisquer documentos existentes
2. Redija todas as seções com base no que encontrar
3. Apresente o rascunho e pergunte o que precisa ser corrigido ou está faltando
4. Itere até que o usuário esteja satisfeito

Se estiver começando do zero: Passe por cada seção abaixo de forma conversacional, uma de cada vez. Não despeje todas as perguntas de uma vez.

Para cada seção:

1. Explique brevemente o que está capturando
2. Faça perguntas relevantes
3. Confirme a precisão
4. Passe para a próxima

Insista por linguagem textual do cliente — frases exatas são mais valiosas do que descrições polidas porque refletem como os clientes realmente pensam e falam, o que torna o texto mais ressonante.

---

Seções a Capturar

1. Visão Geral do Produto

• Descrição em uma linha
• O que faz (2-3 frases)
• Categoria do produto (em que "prateleira" você se encontra — como os clientes pesquisam por você)
• Tipo de produto (SaaS, marketplace, e-commerce, serviço, etc.)
• Modelo de negócios e preços

2. Público-Alvo

• Tipo de empresa-alvo (setor, porte, estágio)
• Tomadores de decisão-alvo (cargos, departamentos)
• Caso de uso principal (o principal problema que você resolve)
• Trabalhos a serem feitos (2-3 coisas para as quais os clientes o "contratam")
• Casos de uso ou cenários específicos

3. Personas (apenas B2B)

Se várias partes interessadas estiverem envolvidas na compra, capture para cada uma:

• Usuário, Patrocinador, Tomador de Decisão, Comprador Financeiro, Influenciador Técnico
• O que cada um valoriza, seu desafio e o valor que você promete a eles

4. Problemas e Pontos de Dor

• Desafio principal que os clientes enfrentam antes de encontrar você
• Por que as soluções atuais são insuficientes
• O que isso custa a eles (tempo, dinheiro, oportunidades)
• Tensão emocional (estresse, medo, dúvida)

5. Cenário Competitivo

• Concorrentes diretos: Mesma solução, mesmo problema (ex.: Calendly vs SavvyCal)
• Concorrentes secundários: Solução diferente, mesmo problema (ex.: Calendly vs agendamento do Superhuman)
• Concorrentes indiretos: Abordagem conflitante (ex.: Calendly vs assistente pessoal)
• Como cada um é insuficiente para os clientes

6. Diferenciação

• Principais diferenciadores (capacidades que as alternativas não têm)
• Como você resolve de forma diferente
• Por que isso é melhor (benefícios)
• Por que os clientes escolhem você em vez das alternativas

7. Objeções e Anti-Personas

• Top 3 objeções ouvidas em vendas e como abordá-las
• Quem NÃO é um bom ajuste (anti-persona)

8. Dinâmica de Troca

As Quatro Forças do JTBD:

• Empurrão: Que frustrações os afastam da solução atual
• Atração: O que os atrai para você
• Hábito: O que os mantém presos à abordagem atual
• Ansiedade: O que os preocupa em mudar

9. Linguagem do Cliente

• Como os clientes descrevem o problema (textual)
• Como eles descrevem sua solução (textual)
• Palavras/frases a usar
• Palavras/frases a evitar
• Glossário de termos específicos do produto

10. Voz da Marca

• Tom (profissional, casual, divertido, etc.)
• Estilo de comunicação (direto, conversacional, técnico)
• Personalidade da marca (3-5 adjetivos)

11. Pontos de Prova

• Principais métricas ou resultados a citar
• Clientes/logos notáveis
• Trechos de depoimentos
• Principais temas de valor e evidências de apoio

12. Objetivos

• Principal objetivo de negócios
• Ação de conversão principal (o que você quer que as pessoas façam)
• Métricas atuais (se conhecidas)

---

Etapa 3: Criar o Documento

Após coletar as informações, crie .agents/product-marketing.md com esta estrutura:

# Contexto de Marketing do Produto

**Versão do documento:** v1
**Última atualização:** [data]

## Visão Geral do Produto
**Descrição em uma linha:**
**O que faz:**
**Categoria do produto:**
**Tipo de produto:**
**Modelo de negócios:**

## Público-Alvo
**Empresas-alvo:**
**Tomadores de decisão:**
**Caso de uso principal:**
**Trabalhos a serem feitos:**
-
**Casos de uso:**
-

## Personas
| Persona | Valoriza | Desafio | Valor que prometemos |
|---------|----------|---------|----------------------|
| | | | |

## Problemas e Pontos de Dor
**Problema principal:**
**Por que as alternativas são insuficientes:**
-
**O que isso custa a eles:**
**Tensão emocional:**

## Cenário Competitivo
**Direto:** [Concorrente] — é insuficiente porque...
**Secundário:** [Abordagem] — é insuficiente porque...
**Indireto:** [Alternativa] — é insuficiente porque...

## Diferenciação
**Principais diferenciadores:**
-
**Como fazemos de forma diferente:**
**Por que isso é melhor:**
**Por que os clientes nos escolhem:**

## Objeções
| Objeção | Resposta |
|---------|----------|
| | |

**Anti-persona:**

## Dinâmica de Troca
**Empurrão:**
**Atração:**
**Hábito:**
**Ansiedade:**

## Linguagem do Cliente
**Como eles descrevem o problema:**
- "[textual]"
**Como eles nos descrevem:**
- "[textual]"
**Palavras a usar:**
**Palavras a evitar:**
**Glossário:**
| Termo | Significado |
|-------|-------------|
| | |

## Voz da Marca
**Tom:**
**Estilo:**
**Personalidade:**

## Pontos de Prova
**Métricas:**
**Clientes:**
**Depoimentos:**
> "[citação]" — [quem]
**Temas de valor:**
| Tema | Prova |
|------|-------|
| | |

## Objetivos
**Objetivo de negócios:**
**Ação de conversão:**
**Métricas atuais:**

## Changelog
*Do mais recente para o mais antigo. Uma linha por revisão: o que mudou e por que.*
- v1 ([data]) — Contexto inicial.

---

Etapa 4: Confirmar, Versionar e Salvar

• Mostre o documento completo
• Pergunte se algo precisa de ajuste
• Defina a versão e o changelog — este é o rastro de papel para um documento que toda outra skill lê:
  • Documento novo: defina Versão do documento: v1 e uma única entrada no Changelog — - v1 ([hoje]) — Contexto inicial.
  • Atualizando um documento existente: incremente a versão (v2 → v3 …), atualize Última atualização para hoje e adicione uma nova entrada no Changelog no topo da lista (do mais recente para o mais antigo) resumindo o que mudou e por que em uma linha. Nunca reescreva ou reordene entradas passadas.
  • Uma boa entrada nomeia as seções tocadas e o motivo, não "documento atualizado." Exemplos:
    • - v3 (2026-07-16) — Reposicionado de "ferramenta de e-mail" para "plataforma de entregabilidade"; adicionou RevOps ao ICP.
    • - v2 (2026-06-02) — Reescreveu proposta de valor e objeções após 5 entrevistas com clientes; adicionou concorrente Acme.
  • Use a data de hoje no formato ISO (AAAA-MM-DD) para a entrada e Última atualização.
  • Correção puramente tipográfica: não incremente a versão nem adicione entrada no changelog — apenas salve a correção. Qualquer outra alteração incrementa a versão e ganha uma entrada. Quando a mudança é um reposicionamento real, diga claramente — as skills downstream agora gerarão com base no novo contexto.
• Salve em .agents/product-marketing.md
• Diga a eles: "Outras habilidades de marketing agora usarão este contexto automaticamente. O Changelog no final rastreia cada revisão — verifique-o para ver como seu posicionamento evoluiu. Execute /product-marketing a qualquer momento para atualizá-lo."

---

Dicas

• Seja específico: Pergunte "Qual é a #1 frustração que os traz até você?" e não "Que problema eles resolvem?"
• Capture palavras exatas: A linguagem do cliente supera descrições polidas
• Peça exemplos: "Você pode me dar um exemplo?" desbloqueia melhores respostas
• Valide conforme avança: Resuma cada seção e confirme antes de prosseguir
• Pule o que não se aplica: Nem todo produto precisa de todas as seções (ex.: Personas para B2C)