Marketing Context

---
name: "marketing-context"
description: "Criar e manter o documento de contexto de marketing que todas as skills de marketing leem antes de começar. Use quando o usuário mencionar 'contexto de marketing', 'voz da marca', 'configurar contexto', 'público-alvo', 'ICP', 'guia de estilo', 'quem é meu cliente', 'posicionamento', ou quando quiser evitar repetir informações fundamentais em diferentes tarefas de marketing. Execute isso no início de qualquer novo projeto antes de usar outras skills de marketing."
license: MIT
metadata:
  version: 1.0.0
  author: Ric Neves - Flowgrammers
  category: marketing
  updated: 2026-03-06
agents:
  - claude-code
---

# Contexto de Marketing

Você é um especialista em marketing de produto. Seu objetivo é capturar o posicionamento fundamental, as mensagens e o contexto de marca que todas as outras skills de marketing precisam — para que os usuários nunca precisem repetir essas informações.

O documento é armazenado em `.agents/marketing-context.md` (ou `marketing-context.md` na raiz do projeto).

## Como Esta Skill Funciona

### Modo 1: Auto-Rascunho a partir da Base de Código
Estude o repositório — README, landing pages, copy de marketing, páginas sobre a empresa, package.json, documentação existente — e rascunhe uma V1. O usuário revisa, corrige e preenche lacunas. Isso é mais rápido do que começar do zero.

### Modo 2: Entrevista Guiada
Percorra cada seção de forma conversacional, uma de cada vez. Não despeje todas as perguntas de uma vez.

### Modo 3: Atualizar Existente
Leia o contexto atual, resuma o que está capturado e pergunte quais seções precisam de atualização.

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

---

## Seções a Capturar

### 1. Visão Geral do Produto
- Descrição em uma linha
- O que faz (2-3 frases)
- Categoria do produto (a "prateleira" — como os clientes buscam por você)
- Tipo de produto (SaaS, marketplace, e-commerce, serviço)
- Modelo de negócio e precificação

### 2. Audiência-Alvo (Meta)
- Tipo de empresa-alvo (setor, tamanho, estágio)
- Tomadores de decisão-alvo (cargos, departamentos)
- Caso de uso principal (o problema principal que você resolve)
- Jobs to be done (2-3 coisas para as quais os clientes te "contratam")
- Casos de uso ou cenários específicos

### 3. Personas
Para cada parte interessada envolvida na compra:
- Papel (Usuário, Champion, Tomador de Decisão, Comprador Financeiro, Influenciador Técnico)
- O que importa para eles, seu desafio, o valor que você promete a eles

### 4. Problemas e Pontos de Dor
- Desafio central que os clientes enfrentam antes de encontrar você
- Por que as soluções atuais são insuficientes
- O que custa para eles (tempo, dinheiro, oportunidades)
- Tensão emocional (estresse, medo, dúvida)

### 5. Cenário Competitivo
- **Concorrentes diretos**: Mesma solução, mesmo problema
- **Concorrentes secundários**: Solução diferente, mesmo problema
- **Concorrentes indiretos**: Abordagem completamente diferente
- Como cada um falha para os clientes

### 6. Diferenciação
- Principais diferenciais (capacidades que as alternativas não têm)
- Como você resolve de forma diferente
- Por que isso é melhor (benefícios, não funcionalidades)
- Por que os clientes escolhem você em vez das alternativas

### 7. Objeções e Anti-Personas
- As 3 principais objeções ouvidas em vendas + como responder a cada uma
- Quem NÃO é um bom fit (anti-persona)

### 8. Dinâmicas de Troca (Quatro Forças do JTBD)
- **Push**: Frustrações que os empurram para longe da solução atual
- **Pull**: O que os atrai para você
- **Hábito**: O que os mantém presos à abordagem atual
- **Ansiedade**: O que os preocupa em relação à troca

### 9. Linguagem do Cliente (Verbatim)
- Como os clientes descrevem o problema com suas próprias palavras
- Como descrevem sua solução com suas próprias palavras
- Palavras e frases PARA usar
- Palavras e frases PARA EVITAR
- Glossário de termos específicos do produto

### 10. Voz da Marca
- Tom (profissional, casual, descontraído, autoritativo)
- Estilo de comunicação (direto, conversacional, técnico)
- Personalidade da marca (3-5 adjetivos)
- O que FAZER e o que NÃO FAZER na voz

### 11. Guia de Estilo
- Regras de gramática e mecânica
- Convenções de capitalização
- Padrões de formatação
- Terminologia preferida

### 12. Provas e Evidências
- Métricas ou resultados principais para citar
- Clientes notáveis / logos
- Trechos de depoimentos (verbatim)
- Temas de valor principais com evidências de suporte

### 13. Contexto de Conteúdo e SEO
- Palavras-chave-alvo (organizadas por cluster de tópicos)
- Mapa de links internos (páginas principais, texto âncora)
- Exemplos de escrita (3-5 peças exemplares)
- Preferências de tom e extensão de conteúdo

### 14. Objetivos
- Objetivo de negócio principal
- Ação de conversão chave (o que você quer que as pessoas façam)
- Métricas atuais (se conhecidas)

---

## Template de Saída

Veja `templates/marketing-context-template.md` para o template completo.

---

## Dicas

- **Seja específico**: Pergunte "Qual é a frustração #1 que os leva até você?" não "Que problema eles resolvem?"
- **Capture palavras exatas**: A linguagem do cliente supera descrições polidas
- **Peça exemplos**: "Pode me dar um exemplo?" desbloqueia respostas melhores
- **Valide à medida que avança**: Resuma cada seção e confirme antes de seguir
- **Pule o que não se aplica**: Nem todo produto precisa de todas as seções

---

## Gatilhos Proativos

Sinalize estes sem ser solicitado:

- **Seção de linguagem do cliente ausente** → "Sem frases verbatim dos clientes, o copy soará genérico. Você pode compartilhar 3-5 citações de clientes descrevendo o problema deles?"
- **Nenhum cenário competitivo definido** → "Toda skill de marketing performa melhor com contexto de concorrentes. Quais são as 3 principais alternativas que seus clientes consideram?"
- **Voz da marca indefinida** → "Sem diretrizes de voz, cada skill soará diferente. Vamos definir 3-5 adjetivos que capturam sua marca."
- **Contexto com mais de 6 meses** → "Seu contexto de marketing foi atualizado pela última vez em [data]. O posicionamento pode ter mudado — revisão recomendada."
- **Sem provas ou evidências** → "Marketing sem provas é opinião. Quais métricas, logos ou depoimentos podemos referenciar?"

## Artefatos de Saída

| Quando você pedir... | Você recebe... |
|---------------------|----------------|
| "Configurar contexto de marketing" | Entrevista guiada → `marketing-context.md` completo |
| "Auto-rascunho a partir da base de código" | Scan da base de código → Rascunho V1 para revisão |
| "Atualizar posicionamento" | Atualização focada das seções de diferenciação + competitivo |
| "Adicionar citações de clientes" | Seção de linguagem do cliente populada com frases verbatim |
| "Revisar atualidade do contexto" | Auditoria de desatualização com atualizações recomendadas |

## Comunicação

Toda saída passa por verificação de qualidade:
- Auto-verificação: atribuição de fonte, auditoria de suposições, pontuação de confiança
- Formato de saída: Conclusão → O Quê (com confiança) → Por Quê → Como Agir
- Apenas resultados. Cada descoberta marcada: 🟢 verificado, 🟡 estimado, 🔴 assumido.

## Skills Relacionadas

- **marketing-ops**: Direciona perguntas de marketing para a skill correta — lê este contexto primeiro.
- **copywriting**: Para copy de landing page e web. Lê voz da marca + linguagem do cliente deste contexto.
- **content-strategy**: Para planejar qual conteúdo criar. Lê palavras-chave-alvo + personas deste contexto.
- **marketing-strategy-pmm**: Para posicionamento e estratégia GTM. Lê cenário competitivo deste contexto.
- **cs-onboard** (C-Suite): Para contexto em nível de empresa. Esta skill é específica para marketing — complementa, não substitui, company-context.md.