Contexto de Marketing de Producto
Ayudas a los usuarios a crear y mantener un documento de contexto de marketing de producto. Esto captura información fundamental de posicionamiento y mensajería que otras habilidades de marketing referencian, para que los usuarios no tengan que repetirse.
El documento se almacena en .agents/product-marketing.md.
Flujo de trabajo
Paso 1: Verificar si existe un contexto
Primero, verifica si .agents/product-marketing.md ya existe. También revisa .claude/product-marketing.md y el nombre de archivo heredado product-marketing-context.md (en .agents/ o .claude/) para configuraciones antiguas: si se encuentra en cualquier lugar que no sea .agents/product-marketing.md, ofrece moverlo a la ubicación canónica.
Si existe:
- Léelo y resume lo que contiene
- Pregunta qué secciones quieren actualizar
- Solo recopila información para esas secciones
Si no existe, ofrece dos opciones:
-
Borrador automático desde la base de código (recomendado): Estudiarás el repositorio —README, páginas de destino, copia de marketing, package.json, etc.— y redactarás una V1 del documento de contexto. Luego, el usuario revisa, corrige y completa los vacíos. Esto es más rápido que empezar desde cero.
-
Empezar desde cero: Recorre cada sección de manera conversacional, recopilando información una sección a la vez.
La mayoría de los usuarios prefieren la opción 1. Después de presentar el borrador, pregunta: "¿Qué necesita corregirse? ¿Qué falta?"
Paso 2: Recopilar información
Si se hace el borrador automático:
- Lee la base de código: README, páginas de destino, copia de marketing, páginas "Acerca de", meta descripciones, package.json, cualquier documento existente
- Redacta todas las secciones basándote en lo que encuentres
- Presenta el borrador y pregunta qué necesita corregirse o qué falta
- Itera hasta que el usuario esté satisfecho
Si se empieza desde cero: Recorre cada sección a continuación de manera conversacional, una a la vez. No sueltes todas las preguntas de golpe.
Para cada sección:
- Explica brevemente lo que estás capturando
- Haz preguntas relevantes
- Confirma la precisión
- Pasa a la siguiente
Insiste en el lenguaje textual del cliente: las frases exactas son más valiosas que las descripciones pulidas porque reflejan cómo piensan y hablan realmente los clientes, lo que hace que el texto sea más resonante.
Secciones a capturar
1. Descripción general del producto
- Descripción en una línea
- Qué hace (2-3 oraciones)
- Categoría de producto (en qué "estante" te ubicas: cómo te buscan los clientes)
- Tipo de producto (SaaS, marketplace, comercio electrónico, servicio, etc.)
- Modelo de negocio y precios
2. Público objetivo
- Tipo de empresa objetivo (industria, tamaño, etapa)
- Tomadores de decisiones objetivo (roles, departamentos)
- Caso de uso principal (el problema principal que resuelves)
- Trabajos a realizar (2-3 cosas para las que los clientes te "contratan")
- Casos de uso o escenarios específicos
3. Personas (solo B2B)
Si hay múltiples partes interesadas involucradas en la compra, captura para cada una:
- Usuario, Defensor, Tomador de decisiones, Comprador financiero, Influyente técnico
- Lo que le importa a cada uno, su desafío y el valor que les prometes
4. Problemas y puntos de dolor
- Desafío principal que enfrentan los clientes antes de encontrarte
- Por qué las soluciones actuales se quedan cortas
- Lo que les cuesta (tiempo, dinero, oportunidades)
- Tensión emocional (estrés, miedo, duda)
5. Panorama competitivo
- Competidores directos: Misma solución, mismo problema (ej., Calendly vs SavvyCal)
- Competidores secundarios: Solución diferente, mismo problema (ej., Calendly vs programación de Superhuman)
- Competidores indirectos: Enfoque conflictivo (ej., Calendly vs asistente personal)
- Cómo cada uno se queda corto para los clientes
6. Diferenciación
- Diferenciadores clave (capacidades que carecen las alternativas)
- Cómo lo resuelves de manera diferente
- Por qué eso es mejor (beneficios)
- Por qué los clientes te eligen sobre las alternativas
7. Objeciones y anti-personas
- Las 3 objeciones principales escuchadas en ventas y cómo abordarlas
- Quién NO es un buen ajuste (anti-persona)
8. Dinámicas de cambio
Las cuatro fuerzas JTBD:
- Empuje: Qué frustraciones los alejan de la solución actual
- Atracción: Qué los atrae hacia ti
- Hábito: Qué los mantiene atascados con el enfoque actual
- Ansiedad: Qué les preocupa sobre el cambio
9. Lenguaje del cliente
- Cómo describen los clientes el problema (textualmente)
- Cómo describen tu solución (textualmente)
- Palabras/frases a usar
- Palabras/frases a evitar
- Glosario de términos específicos del producto
10. Voz de la marca
- Tono (profesional, casual, juguetón, etc.)
- Estilo de comunicación (directo, conversacional, técnico)
- Personalidad de la marca (3-5 adjetivos)
11. Puntos de prueba
- Métricas o resultados clave a citar
- Clientes/logos notables
- Fragmentos de testimonios
- Temas de valor principales y evidencia de respaldo
12. Objetivos
- Objetivo principal del negocio
- Acción clave de conversión (lo que quieres que la gente haga)
- Métricas actuales (si se conocen)
Paso 3: Crear el documento
Después de recopilar la información, crea .agents/product-marketing.md con esta estructura:
# Contexto de Marketing de Producto
*Última actualización: [date]*
## Descripción general del producto
**En una línea:**
**Qué hace:**
**Categoría de producto:**
**Tipo de producto:**
**Modelo de negocio:**
## Público objetivo
**Empresas objetivo:**
**Tomadores de decisiones:**
**Caso de uso principal:**
**Trabajos a realizar:**
-
**Casos de uso:**
-
## Personas
| Persona | Le importa | Desafío | Valor que prometemos |
|---------|-------------|-----------|------------------|
| | | | |
## Problemas y puntos de dolor
**Problema central:**
**Por qué las alternativas se quedan cortas:**
-
**Lo que les cuesta:**
**Tensión emocional:**
## Panorama competitivo
**Directo:** [Competidor] — se queda corto porque...
**Secundario:** [Enfoque] — se queda corto porque...
**Indirecto:** [Alternativa] — se queda corto porque...
## Diferenciación
**Diferenciadores clave:**
-
**Cómo lo hacemos diferente:**
**Por qué eso es mejor:**
**Por qué los clientes nos eligen:**
## Objeciones
| Objeción | Respuesta |
|-----------|----------|
| | |
**Anti-persona:**
## Dinámicas de cambio
**Empuje:**
**Atracción:**
**Hábito:**
**Ansiedad:**
## Lenguaje del cliente
**Cómo describen el problema:**
- "[textual]"
**Cómo nos describen:**
- "[textual]"
**Palabras a usar:**
**Palabras a evitar:**
**Glosario:**
| Término | Significado |
|------|---------|
| | |
## Voz de la marca
**Tono:**
**Estilo:**
**Personalidad:**
## Puntos de prueba
**Métricas:**
**Clientes:**
**Testimonios:**
> "[cita]" — [quién]
**Temas de valor:**
| Tema | Prueba |
|-------|-------|
| | |
## Objetivos
**Objetivo del negocio:**
**Acción de conversión:**
**Métricas actuales:**
Paso 4: Confirmar y guardar
- Muestra el documento terminado
- Pregunta si necesita algún ajuste
- Guarda en
.agents/product-marketing.md - Diles: "Otras habilidades de marketing ahora usarán este contexto automáticamente. Ejecuta
/product-marketingen cualquier momento para actualizarlo."
Consejos
- Sé específico: Pregunta "¿Cuál es la frustración #1 que los trae a ti?" en lugar de "¿Qué problema resuelven?"
- Captura palabras exactas: El lenguaje del cliente supera a las descripciones pulidas
- Pide ejemplos: "¿Puedes darme un ejemplo?" desbloquea mejores respuestas
- Valida sobre la marcha: Resume cada sección y confirma antes de seguir adelante
- Omite lo que no sea aplicable: No todos los productos necesitan todas las secciones (ej., Personas para B2C)