contexto-de-marketing-de-producto

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 a la que otros skills de marketing hacen referencia, 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 Contexto

Primero, verifica si .agents/product-marketing.md ya existe. También verifica .claude/product-marketing.md y el nombre de archivo heredado product-marketing-context.md (ya sea en .agents/ o .claude/) para configuraciones antiguas; si se encuentra en algún lugar que no sea .agents/product-marketing.md, ofrece moverlo a la ubicación canónica.

Si existe:

• Léelo y resume lo que está capturado: anota su versión del documento actual y las últimas entradas del Registro de cambios para que el usuario vea en qué punto está el documento y qué ha cambiado recientemente
• Pregunta qué secciones desea actualizar
• Solo recopila información para esas secciones
• En cada guardado sustancial, incrementa la versión y añade una entrada en el registro de cambios (ver Paso 4). Este documento es el contexto compartido que leen todos los demás skills de marketing, por lo que vale la pena mantener un rastro fechado de qué cambió y por qué.

Si no existe, ofrece dos opciones:

1. Borrador automático desde el código base (recomendado): Estudiarás el repositorio (README, páginas de aterrizaje, textos de marketing, package.json, etc.) y redactarás un 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.

2. Empezar desde cero: Recorre cada sección de forma 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 corrección? ¿Qué falta?"

Paso 2: Recopilar Información

Si se hace un borrador automático:

1. Lee el código base: README, páginas de aterrizaje, textos de marketing, páginas "Acerca de", meta descripciones, package.json, cualquier documento existente
2. Redacta todas las secciones basándote en lo que encuentres
3. Presenta el borrador y pregunta qué necesita corrección o qué falta
4. Itera hasta que el usuario esté satisfecho

Si se empieza desde cero: Recorre cada sección a continuación de forma conversacional, una a la vez. No hagas todas las preguntas de una vez.

Para cada sección:

1. Explica brevemente qué estás capturando
2. Haz preguntas relevantes
3. Confirma la precisión
4. Pasa a la siguiente

Insiste en el lenguaje literal del cliente: las frases exactas son más valiosas que las descripciones refinadas porque reflejan cómo piensan y hablan realmente los clientes, lo que hace que los textos sean más resonantes.

---

Secciones a Capturar

1. Panorama General del Producto

• Descripción en una línea
• Qué hace (2-3 frases)
• Categoría del producto (en qué "estante" te ubicas—cómo te buscan los clientes)
• Tipo de producto (SaaS, marketplace, e-commerce, servicio, etc.)
• Modelo de negocio y precios

2. Audiencia 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 por hacer (2-3 cosas para las que los clientes te "contratan")
• Casos de uso o escenarios específicos

3. Personas (solo B2B)

Si múltiples interesados participan en la compra, captura para cada uno:

• Usuario, Defensor, Tomador de Decisiones, Comprador Financiero, Influenciador Técnico
• Qué le importa a cada uno, su desafío y el valor que le prometes

4. Problemas y Puntos de Dolor

• Desafío central que enfrentan los clientes antes de encontrarte
• Por qué las soluciones actuales son insuficientes
• Qué 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 falla 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 a ti 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 candidato (anti-persona)

8. Dinámicas de Cambio

Las Cuatro Fuerzas de 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 al cambiar

9. Lenguaje del Cliente

• Cómo describen el problema los clientes (textual)
• Cómo describen tu solución (textual)
• Palabras/frases para usar
• Palabras/frases para evitar
• Glosario de términos específicos del producto

10. Voz de Marca

• Tono (profesional, casual, divertido, 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 para citar
• Clientes notables/logos
• Fragmentos de testimonios
• Temas de valor principales y evidencia de apoyo

12. Objetivos

• Objetivo comercial principal
• Acción de conversión clave (qué 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

**Versión del documento:** v1
**Última actualización:** [fecha]

## Panorama General del Producto
**Resumen en una línea:**
**Qué hace:**
**Categoría del producto:**
**Tipo de producto:**
**Modelo de negocio:**

## Audiencia Objetivo
**Empresas objetivo:**
**Tomadores de decisiones:**
**Caso de uso principal:**
**Trabajos por hacer:**
-
**Casos de uso:**
-

## Personas
| Persona | Le importa | Desafío | Valor que prometemos |
|---------|------------|---------|----------------------|
| | | | |

## Problemas y Puntos de Dolor
**Problema central:**
**Por qué las alternativas fallan:**
-
**Qué les cuesta:**
**Tensión emocional:**

## Panorama Competitivo
**Directo:** [Competidor] — falla porque...
**Secundario:** [Enfoque] — falla porque...
**Indirecto:** [Alternativa] — falla porque...

## Diferenciación
**Diferenciadores clave:**
-
**Cómo lo hacemos de manera 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 para usar:**
**Palabras para evitar:**
**Glosario:**
| Término | Significado |
|---------|-------------|
| | |

## Voz de Marca
**Tono:**
**Estilo:**
**Personalidad:**

## Puntos de Prueba
**Métricas:**
**Clientes:**
**Testimonios:**
> "[cita]" — [quién]
**Temas de valor:**
| Tema | Prueba |
|------|--------|
| | |

## Objetivos
**Objetivo comercial:**
**Acción de conversión:**
**Métricas actuales:**

## Registro de Cambios
*Más reciente primero. Una línea por revisión: qué cambió y por qué.*
- v1 ([fecha]) — Contexto inicial.

---

Paso 4: Confirmar, Versionar y Guardar

• Muestra el documento completado
• Pregunta si necesita algún ajuste
• Establece la versión y el registro de cambios — este es el rastro documental para un documento que leen todos los demás skills:
  • Documento nuevo: establece Versión del documento: v1 y una única entrada en el Registro de cambios: - v1 ([hoy]) — Contexto inicial.
  • Actualizando un documento existente: incrementa la versión (v2 → v3 …), actualiza Última actualización a hoy y antepón una nueva entrada al Registro de cambios al inicio de la lista (la más reciente primero) resumiendo qué cambió y por qué en una línea. Nunca reescribas ni reordenes entradas pasadas.
  • Una buena entrada nombra las secciones tocadas y la razón, no "actualicé el doc." Ejemplos:
    • - v3 (2026-07-16) — Reposicionado de "herramienta de correo" a "plataforma de entregabilidad"; agregó RevOps al ICP.
    • - v2 (2026-06-02) — Reescrito propuesta de valor y objeciones después de 5 entrevistas con clientes; agregó competidor Acme.
  • Usa la fecha de hoy en formato ISO (AAAA-MM-DD) para la entrada y Última actualización.
  • Corrección puramente de errores tipográficos: no incrementes la versión ni agregues entrada al registro de cambios—solo guarda la corrección. Cualquier otro cambio incrementa la versión y obtiene una entrada. Cuando el cambio es un reposicionamiento real, dilo claramente—los skills posteriores ahora generarán contenido basado en el nuevo contexto.
• Guarda en .agents/product-marketing.md
• Diles: "Otros skills de marketing ahora usarán este contexto automáticamente. El Registro de Cambios al final rastrea cada revisión—revísalo para ver cómo ha evolucionado tu posicionamiento. Ejecuta /product-marketing en cualquier momento para actualizarlo."

---

Consejos

• Sé específico: Pregunta "¿Cuál es la frustración #1 que los trae a ti?" no "¿Qué problema resuelven?"
• Captura palabras exactas: El lenguaje del cliente supera a las descripciones refinadas
• 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 aplique: No todos los productos necesitan todas las secciones (ej., Personas para B2C)