Competenza dell'agente per il contesto di marketing del prodotto

Contesto di Product Marketing

Aiuti gli utenti a creare e mantenere un documento di contesto di product marketing. Questo cattura le informazioni fondamentali di posizionamento e messaggistica a cui fanno riferimento altre competenze di marketing, in modo che gli utenti non debbano ripetersi.

Il documento viene archiviato in .agents/product-marketing.md.

Flusso di lavoro

Passaggio 1: Verificare l'esistenza del contesto

Innanzitutto, verifica se .agents/product-marketing.md esiste già. Controlla anche .claude/product-marketing.md e il nome file legacy product-marketing-context.md (in .agents/ o .claude/) per configurazioni meno recenti — se trovato in una posizione diversa da .agents/product-marketing.md, offri di spostarlo nella posizione canonica.

Se esiste:

• Leggilo e riassumi ciò che è stato catturato
• Chiedi quali sezioni vogliono aggiornare
• Raccogli informazioni solo per quelle sezioni

Se non esiste, offri due opzioni:

1. Bozza automatica dal codebase (consigliata): Studierai il repository — README, pagine di destinazione, testi di marketing, package.json, ecc. — e redigerai una versione V1 del documento di contesto. L'utente poi rivedrà, correggerà e riempirà le lacune. Questo è più veloce che partire da zero.

2. Partire da zero: Percorri ogni sezione in modo conversazionale, raccogliendo informazioni una sezione alla volta.

La maggior parte degli utenti preferisce l'opzione 1. Dopo aver presentato la bozza, chiedi: "Cosa deve essere corretto? Cosa manca?"

Passaggio 2: Raccogliere informazioni

Se si utilizza la bozza automatica:

1. Leggi il codebase: README, pagine di destinazione, testi di marketing, pagine "about", meta descrizioni, package.json, qualsiasi documentazione esistente
2. Redigi tutte le sezioni basandoti su ciò che trovi
3. Presenta la bozza e chiedi cosa deve essere corretto o cosa manca
4. Itera fino a quando l'utente non è soddisfatto

Se si parte da zero: Percorri ogni sezione qui sotto in modo conversazionale, una alla volta. Non riversare tutte le domande in una volta sola.

Per ogni sezione:

1. Spiega brevemente cosa stai catturando
2. Fai domande pertinenti
3. Conferma l'accuratezza
4. Passa alla successiva

Cerca di ottenere il linguaggio testuale dei clienti — le frasi esatte sono più preziose di descrizioni raffinate perché riflettono come i clienti pensano e parlano realmente, il che rende il copy più risonante.

Sezioni da catturare

1. Panoramica del prodotto

• Descrizione in una frase
• Cosa fa (2-3 frasi)
• Categoria di prodotto (su quale "scaffale" ti trovi — come i clienti ti cercano)
• Tipo di prodotto (SaaS, marketplace, e-commerce, servizio, ecc.)
• Modello di business e prezzi

2. Pubblico target

• Tipo di azienda target (settore, dimensioni, fase)
• Decisori target (ruoli, dipartimenti)
• Caso d'uso principale (il problema principale che risolvi)
• Lavori da svolgere (2-3 cose per cui i clienti ti "assumono")
• Casi d'uso o scenari specifici

3. Personas (solo B2B)

Se più stakeholder sono coinvolti nell'acquisto, cattura per ciascuno:

• Utente, Campione, Decisore, Acquirente finanziario, Influenzatore tecnico
• Cosa interessa a ciascuno, la loro sfida e il valore che prometti loro

4. Problemi e punti dolenti

• Sfida principale che i clienti affrontano prima di trovarti
• Perché le soluzioni attuali sono insufficienti
• Cosa costa loro (tempo, denaro, opportunità)
• Tensione emotiva (stress, paura, dubbio)

5. Panorama competitivo

• Concorrenti diretti: Stessa soluzione, stesso problema (es. Calendly vs SavvyCal)
• Concorrenti secondari: Soluzione diversa, stesso problema (es. Calendly vs la schedulazione di Superhuman)
• Concorrenti indiretti: Approccio in conflitto (es. Calendly vs assistente personale)
• Come ciascuno risulta carente per i clienti

6. Differenziazione

• Differenziatori chiave (capacità che le alternative non hanno)
• Come lo risolvi in modo diverso
• Perché è migliore (benefici)
• Perché i clienti ti scelgono rispetto alle alternative

7. Obiezioni e anti-personas

• Le prime 3 obiezioni ascoltate nelle vendite e come affrontarle
• Chi NON è un buon candidato (anti-persona)

8. Dinamiche di passaggio

Le quattro forze del JTBD:

• Spinta: Quali frustrazioni li allontanano dalla soluzione attuale
• Attrazione: Cosa li attrae verso di te
• Abitudine: Cosa li tiene bloccati con l'approccio attuale
• Ansia: Cosa li preoccupa del passaggio

9. Linguaggio del cliente

• Come i clienti descrivono il problema (testuale)
• Come descrivono la tua soluzione (testuale)
• Parole/frasi da usare
• Parole/frasi da evitare
• Glossario dei termini specifici del prodotto

10. Voce del brand

• Tono (professionale, informale, giocoso, ecc.)
• Stile di comunicazione (diretto, conversazionale, tecnico)
• Personalità del brand (3-5 aggettivi)

11. Punti di prova

• Metriche o risultati chiave da citare
• Clienti/loghi degni di nota
• Frammenti di testimonianze
• Temi di valore principali e prove a supporto

12. Obiettivi

• Obiettivo di business principale
• Azione di conversione chiave (cosa vuoi che le persone facciano)
• Metriche attuali (se note)

Passaggio 3: Creare il documento

Dopo aver raccolto le informazioni, crea .agents/product-marketing.md con questa struttura:

# Product Marketing Context

*Ultimo aggiornamento: [data]*

## Panoramica del prodotto
**Frase riassuntiva:**
**Cosa fa:**
**Categoria di prodotto:**
**Tipo di prodotto:**
**Modello di business:**

## Pubblico target
**Aziende target:**
**Decisori:**
**Caso d'uso principale:**
**Lavori da svolgere:**
-
**Casi d'uso:**
-

## Personas
| Persona | Cosa le interessa | Sfida | Valore che promettiamo |
|---------|-------------------|-------|------------------------|
| | | | |

## Problemi e punti dolenti
**Problema principale:**
**Perché le alternative sono carenti:**
-
**Cosa costa loro:**
**Tensione emotiva:**

## Panorama competitivo
**Diretti:** [Concorrente] — carente perché...
**Secondari:** [Approccio] — carente perché...
**Indiretti:** [Alternativa] — carente perché...

## Differenziazione
**Differenziatori chiave:**
-
**Come lo facciamo in modo diverso:**
**Perché è migliore:**
**Perché i clienti ci scelgono:**

## Obiezioni
| Obiezione | Risposta |
|-----------|----------|
| | |

**Anti-persona:**

## Dinamiche di passaggio
**Spinta:**
**Attrazione:**
**Abitudine:**
**Ansia:**

## Linguaggio del cliente
**Come descrivono il problema:**
- "[testuale]"
**Come ci descrivono:**
- "[testuale]"
**Parole da usare:**
**Parole da evitare:**
**Glossario:**
| Termine | Significato |
|--------|-------------|
| | |

## Voce del brand
**Tono:**
**Stile:**
**Personalità:**

## Punti di prova
**Metriche:**
**Clienti:**
**Testimonianze:**
> "[citazione]" — [chi]
**Temi di valore:**
| Tema | Prova |
|------|-------|
| | |

## Obiettivi
**Obiettivo di business:**
**Azione di conversione:**
**Metriche attuali:**

Passaggio 4: Confermare e salvare

• Mostra il documento completato
• Chiedi se qualcosa richiede modifiche
• Salva in .agents/product-marketing.md
• Di' loro: "Le altre competenze di marketing useranno ora questo contesto automaticamente. Esegui /product-marketing in qualsiasi momento per aggiornarlo."

Suggerimenti

• Sii specifico: Chiedi "Qual è la frustrazione n. 1 che li porta da te?" non "Che problema risolvono?"
• Cattura parole esatte: Il linguaggio del cliente batte le descrizioni raffinate
• Chiedi esempi: "Puoi farmi un esempio?" sblocca risposte migliori
• Convalida man mano: Riassumi ogni sezione e conferma prima di procedere
• Salta ciò che non si applica: Non tutti i prodotti necessitano di tutte le sezioni (es. Personas per B2C)