product-marketing-context

name	product-marketing-context
description	Use when the user wants to criar ou atualizar documento de contexto de product marketing (positioning, ICP, JTBD, personas, competitive landscape). Examples: "monta positioning do meu produto", "cria context doc pra usar em outras skills", "ICP e personas do Metricaas", "product context", "positioning", "ICP", "personas", "set up context". NÃO use para: Usuário quer copy específica; Quer estratégia de conteúdo; Quer pricing.
type	skill
category	marketing
status	ATIVO
version	2
created	"2026-04-18T00:00:00.000Z"
last_reviewed	"2026-04-18T00:00:00.000Z"
estimated_time	60min
model_compatible	["claude-sonnet-4","claude-opus-4","gpt-5","gpt-4o","gemini-pro"]

Como usar este arquivo — Arraste-o num chat de IA (ChatGPT, Claude ou Gemini) e fale em português normal. Avisos pra quem está começando:

• Termos: ICP = seu cliente ideal. JTBD = o "trabalho" que o cliente contrata seu produto pra fazer ("contratei o AgendaZap pra parar de perder cliente que falta"). Positioning = como o cliente te encaixa na cabeça dele.
• Ignore os comandos de terminal (ls, mkdir, salvar em .agents/) — isso é pra quem usa o Claude Code. Num chat comum, a IA entrega o documento aqui no chat: copie e cole num Google Docs, e cole de volta no começo da conversa quando for usar outra skill (é assim que a IA "lembra" do seu produto).
• Ignore skills que ela citar e não vierem no seu kit (ex: pricing-strategy) — fazem parte do Pixel AI Hub.

Product Marketing Context

When to Use

Aciona quando:

• Usuário quer criar documento fundacional de product marketing
• Vai usar várias skills de marketing e quer evitar repetir info
• Precisa formalizar: positioning, ICP, JTBD, personas, differentiators, objections
• Menciona: "product context", "positioning", "ICP", "personas", "set up context"

Exemplos literais:

• "Cria product marketing context pro Metricaas"
• "Quero um doc que as outras skills leiam"
• "Positioning oficial do meu SaaS"

When NOT to Use

NÃO aciona se:

• Usuário quer copy específica → usa copywriting
• Quer estratégia de conteúdo → usa content-strategy
• Quer pricing → usa pricing-strategy

Inputs

Parâmetro	Tipo	Obrigatório	Descrição
mode	string	Sim	auto_draft (estudar repo) / from_scratch (walkthrough) / update
product_name	string	Sim	Nome do produto
repo_path	string	Não	(se auto-draft) path do codebase pra ler
customer_transcripts	list	Não	(se disponível) calls, surveys

Step-by-Step

1. Checar documento existente:

   ls -la .agents/product-marketing-context.md 2>/dev/null
   ls -la .claude/product-marketing-context.md 2>/dev/null
   

   Se existe em .claude/, oferecer mover pra .agents/.

2. Se existe — ler e sumarizar. Perguntar quais seções atualizar.

3. Se não existe — oferecer 2 opções:

   • Auto-draft (recomendado): ler codebase (README, landing, marketing copy, meta descriptions, package.json), drafta V1, user revisa
   • From scratch: walk por cada seção conversacionalmente

4. Seções a capturar (12 seções):

   1. Product Overview:

   • One-liner (1 frase)
   • What it does (2-3 frases)
   • Product category ("shelf" onde cliente busca)
   • Product type (SaaS, marketplace, e-commerce)
   • Business model + pricing

   2. Target Audience:

   • Target company (indústria, tamanho, estágio)
   • Decision-makers (roles, departamentos)
   • Primary use case
   • Jobs to be done (2-3 "contratações")
   • Specific use cases

   3. Personas (B2B, múltiplos stakeholders):

   • User, Champion, Decision Maker, Financial Buyer, Technical Influencer
   • Para cada: o que importam, challenge, value promise

   4. Problems & Pain Points:

   • Core challenge antes de encontrar você
   • Por que alternatives falham
   • Custo (tempo, dinheiro, oportunidade)
   • Tensão emocional (stress, medo, dúvida)

   5. Competitive Landscape:

   • Direct (mesma solução, mesmo problema — Calendly vs SavvyCal)
   • Secondary (solução diferente, mesmo problema)
   • Indirect (abordagem conflitante — Calendly vs assistente pessoal)
   • Como cada falha pro cliente

   6. Differentiation:

   • Differentiators-chave
   • Como você resolve diferente
   • Por que é melhor (benefits)
   • Por que escolhem você

   7. Objections & Anti-Personas:

   • Top 3 objeções + response
   • Quem NÃO é bom fit

   8. Switching Dynamics (JTBD 4 Forces):

   • Push: frustrações afastam do atual
   • Pull: o que atrai a você
   • Habit: o que mantém no atual
   • Anxiety: preocupações em trocar

   9. Customer Language (CRÍTICO — verbatim):

   • Como descrevem o problema (frase exata)
   • Como descrevem você (frase exata)
   • Palavras pra USAR
   • Palavras pra EVITAR
   • Glossary

   10. Brand Voice:

   • Tone (profissional, casual, playful)
   • Style (direto, conversacional, técnico)
   • Personality (3-5 adjetivos)

   11. Proof Points:

   • Métricas a citar
   • Customers notáveis / logos
   • Testemunho snippets
   • Value themes + evidência

   12. Goals:

   • Business goal primário
   • Key conversion action
   • Métricas atuais

5. Push por linguagem verbatim — frases EXATAS que clientes usam batem polished descriptions.

6. Validar seção por seção — sumarizar, confirmar, mover pra próxima.

7. Criar documento em .agents/product-marketing-context.md:

   # Product Marketing Context
   
   *Last updated: [data]*
   
   ## Product Overview
   **One-liner:**
   **What it does:**
   **Product category:**
   **Product type:**
   **Business model:**
   
   ## Target Audience
   **Target companies:**
   **Decision-makers:**
   **Primary use case:**
   **Jobs to be done:**
   -
   **Use cases:**
   -
   
   ## Personas
   | Persona | Cares about | Challenge | Value we promise |
   |---------|-------------|-----------|------------------|
   | | | | |
   
   ## Problems & Pain Points
   **Core problem:**
   **Why alternatives fall short:**
   -
   **What it costs them:**
   **Emotional tension:**
   
   ## Competitive Landscape
   **Direct:** [Competitor] — falls short because...
   **Secondary:** [Approach] — falls short because...
   **Indirect:** [Alternative] — falls short because...
   
   ## Differentiation
   **Key differentiators:**
   -
   **How we do it differently:**
   **Why that's better:**
   **Why customers choose us:**
   
   ## Objections
   | Objection | Response |
   |-----------|----------|
   | | |
   
   **Anti-persona:**
   
   ## Switching Dynamics
   **Push:**
   **Pull:**
   **Habit:**
   **Anxiety:**
   
   ## Customer Language
   **How they describe the problem:**
   - "[verbatim]"
   **How they describe us:**
   - "[verbatim]"
   **Words to use:**
   **Words to avoid:**
   **Glossary:**
   | Term | Meaning |
   |------|---------|
   
   ## Brand Voice
   **Tone:**
   **Style:**
   **Personality:**
   
   ## Proof Points
   **Metrics:**
   **Customers:**
   **Testimonials:**
   > "[quote]" — [quem]
   **Value themes:**
   | Theme | Proof |
   |-------|-------|
   | | |
   
   ## Goals
   **Business goal:**
   **Conversion action:**
   **Current metrics:**
   

8. Salvar arquivo:

   mkdir -p .agents
   # Escrever em .agents/product-marketing-context.md
   

9. Notificar usuário: "Outras skills marketing vão usar esse contexto automaticamente. Rode product-marketing-context novamente pra atualizar."

Outputs

Campo	Tipo	Descrição
context_doc	file	.agents/product-marketing-context.md
gaps	list	Seções com info incompleta pra enriquecer depois

Formato: arquivo markdown estruturado.

Examples

Example 1: Auto-draft Metricaas

Input: "Cria context pro Metricaas. Auto-draft do repo." O que faz:

1. Lê README, landing, pricing page, meta
2. Drafta todas 12 seções baseado no que achou
3. Apresenta draft com flags: "Não achei testemunhos verbatim — pode me passar 2-3?"
4. Itera até satisfeito
5. Salva em .agents/product-marketing-context.md

Example 2: Update section

Input: "Atualiza a seção Objections do context existente." O que faz:

1. Lê arquivo atual
2. Foca só em Objections
3. Pergunta: "Top 3 objeções recentes em calls?"
4. Atualiza só essa seção + date updated

Dependencies

• APIs: nenhuma
• MCPs: Read, Glob, Grep (pra ler repo se auto-draft)
• Env vars: nenhuma
• Files: .agents/product-marketing-context.md (output), repo files (input)
• Outras skills: esta alimenta TODAS outras skills marketing — rodar antes delas

Errors & Recovery

Erro	Causa provável	Fix
Sections vazias	Sem input de customer research	Marcar placeholder + agendar customer calls
Linguagem polished não verbatim	User escreveu "em marketing speak"	Forçar: "exatamente o que cliente disse na última call?"
Competitive landscape genérico	Não pesquisou concorrente	Pedir 2-3h de research com skill competitor-alternatives

Notes

• Customer language verbatim é o item mais valioso. "O problema é que minha planilha quebra quando cresce" > "Enfrentam desafios de escalabilidade".
• Skill DEVE rodar ANTES de outras skills marketing pra gerar melhor output.
• Update trimestral recomendado — produto evolui, competitive landscape muda.
• Se você tem mais de um produto, o contexto de cada um é DIFERENTE. Um doc por produto.