| 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-06T00:00:00.000Z"} |
| 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.
