product-marketing

Contexte Marketing Produit

Vous aidez les utilisateurs à créer et maintenir un document de contexte marketing produit. Ce document capture les informations fondamentales de positionnement et de messagerie auxquelles les autres compétences marketing se réfèrent, évitant ainsi aux utilisateurs de se répéter.

Le document est stocké dans .agents/product-marketing.md.

Flux de travail

Étape 1 : Vérifier l'existence d'un contexte

Commencez par vérifier si .agents/product-marketing.md existe déjà. Vérifiez également .claude/product-marketing.md et l'ancien nom de fichier product-marketing-context.md (dans .agents/ ou .claude/) pour les configurations plus anciennes — si vous le trouvez ailleurs que dans .agents/product-marketing.md, proposez de le déplacer vers l'emplacement canonique.

S'il existe :

• Lisez-le et résumez ce qui est capturé — notez sa version de document actuelle et les dernières entrées du Journal des modifications pour que l'utilisateur voie où en est le document et ce qui a changé récemment.
• Demandez quelles sections ils souhaitent mettre à jour.
• Ne recueillez des informations que pour ces sections.
• Lors de toute sauvegarde substantielle, incrémentez la version et ajoutez une entrée au journal des modifications (voir Étape 4). Ce document est le contexte partagé que chaque autre compétence marketing lit, donc une piste de décision datée de ce qui a changé et pourquoi vaut la peine d'être conservée.

S'il n'existe pas, proposez deux options :

1. Brouillon automatique à partir du codebase (recommandé) : Vous étudierez le dépôt — README, pages de destination, contenu marketing, package.json, etc. — et rédigerez une première version du document de contexte. L'utilisateur révise ensuite, corrige et comble les lacunes. C'est plus rapide que de partir de zéro.

2. Partir de zéro : Parcourez chaque section de manière conversationnelle, en recueillant les informations une section à la fois.

La plupart des utilisateurs préfèrent l'option 1. Après avoir présenté le brouillon, demandez : « Qu'est-ce qui a besoin d'être corrigé ? Qu'est-ce qui manque ? »

Étape 2 : Recueillir les informations

Si vous faites un brouillon automatique :

1. Lisez le codebase : README, pages de destination, contenu marketing, pages « à propos », métadonnées de description, package.json, toute documentation existante.
2. Rédigez toutes les sections en fonction de ce que vous trouvez.
3. Présentez le brouillon et demandez ce qui doit être corrigé ou ce qui manque.
4. Itérez jusqu'à ce que l'utilisateur soit satisfait.

Si vous partez de zéro : Parcourez chaque section ci-dessous de manière conversationnelle, une à la fois. Ne posez pas toutes les questions en même temps.

Pour chaque section :

1. Expliquez brièvement ce que vous capturez.
2. Posez des questions pertinentes.
3. Confirmez l'exactitude.
4. Passez à la suivante.

Recherchez le langage textuel du client — les phrases exactes sont plus précieuses que les descriptions polies car elles reflètent comment les clients pensent et parlent réellement, ce qui rend la copie plus percutante.

---

Sections à capturer

1. Aperçu du produit

• Description en une ligne
• Ce qu'il fait (2-3 phrases)
• Catégorie de produit (sur quel « rayon » vous vous situez — comment les clients vous recherchent)
• Type de produit (SaaS, marketplace, e-commerce, service, etc.)
• Modèle économique et tarification

2. Public cible

• Type d'entreprise cible (secteur, taille, stade)
• Décideurs cibles (rôles, départements)
• Cas d'utilisation principal (le principal problème que vous résolvez)
• Jobs to be done (2-3 choses pour lesquelles les clients vous « embauchent »)
• Cas d'utilisation ou scénarios spécifiques

3. Personas (B2B uniquement)

Si plusieurs parties prenantes sont impliquées dans l'achat, capturez pour chacune :

• Utilisateur, Champion, Décideur, Acheteur financier, Influenceur technique
• Ce qui importe à chacun, leur défi, et la valeur que vous leur promettez

4. Problèmes et points de douleur

• Défi principal auquel les clients sont confrontés avant de vous trouver
• Pourquoi les solutions actuelles sont insuffisantes
• Ce que cela leur coûte (temps, argent, opportunités)
• Tension émotionnelle (stress, peur, doute)

5. Paysage concurrentiel

• Concurrents directs : Même solution, même problème (par exemple, Calendly vs SavvyCal)
• Concurrents secondaires : Solution différente, même problème (par exemple, Calendly vs la planification de Superhuman)
• Concurrents indirects : Approche conflictuelle (par exemple, Calendly vs assistant personnel)
• Comment chacun échoue pour les clients

6. Différenciation

• Principaux facteurs de différenciation (capacités que les alternatives n'ont pas)
• Comment vous résolvez le problème différemment
• Pourquoi c'est mieux (avantages)
• Pourquoi les clients vous choisissent plutôt que les alternatives

7. Objections et anti-personas

• Top 3 des objections entendues dans les ventes et comment y répondre
• Qui n'est PAS un bon candidat (anti-persona)

8. Dynamique de changement

Les quatre forces du JTBD (Jobs to be Done) :

• Poussée : Quelles frustrations les éloignent de la solution actuelle
• Attraction : Qu'est-ce qui les attire vers vous
• Habitude : Qu'est-ce qui les maintient coincés avec l'approche actuelle
• Anxiété : Qu'est-ce qui les inquiète à propos du changement

9. Langage client

• Comment les clients décrivent le problème (textuel)
• Comment ils décrivent votre solution (textuel)
• Mots/phrases à utiliser
• Mots/phrases à éviter
• Glossaire des termes spécifiques au produit

10. Voix de marque

• Ton (professionnel, décontracté, ludique, etc.)
• Style de communication (direct, conversationnel, technique)
• Personnalité de la marque (3-5 adjectifs)

11. Preuves

• Indicateurs ou résultats clés à citer
• Clients/logos notables
• Extrait de témoignages
• Thèmes de valeur principaux et preuves à l'appui

12. Objectifs

• Objectif commercial principal
• Action de conversion clé (ce que vous voulez que les gens fassent)
• Indicateurs actuels (si connus)

---

Étape 3 : Créer le document

Après avoir recueilli les informations, créez .agents/product-marketing.md avec cette structure :

# Contexte Marketing Produit

**Version du document :** v1
**Dernière mise à jour :** [date]

## Aperçu du produit
**Phrase d'accroche :**
**Ce qu'il fait :**
**Catégorie de produit :**
**Type de produit :**
**Modèle économique :**

## Public cible
**Entreprises cibles :**
**Décideurs :**
**Cas d'utilisation principal :**
**Jobs to be done :**
-
**Cas d'utilisation :**
-

## Personas
| Persona | Se soucie de | Défi | Valeur promise |
|---------|--------------|------|----------------|
| | | | |

## Problèmes et points de douleur
**Problème principal :**
**Pourquoi les alternatives sont insuffisantes :**
-
**Ce que cela leur coûte :**
**Tension émotionnelle :**

## Paysage concurrentiel
**Direct :** [Concurrent] — échoue parce que...
**Secondaire :** [Approche] — échoue parce que...
**Indirect :** [Alternative] — échoue parce que...

## Différenciation
**Principaux facteurs de différenciation :**
-
**Comment nous faisons différemment :**
**Pourquoi c'est mieux :**
**Pourquoi les clients nous choisissent :**

## Objections
| Objection | Réponse |
|-----------|---------|
| | |

**Anti-persona :**

## Dynamique de changement
**Poussée :**
**Attraction :**
**Habitude :**
**Anxiété :**

## Langage client
**Comment ils décrivent le problème :**
- "[textuel]"
**Comment ils nous décrivent :**
- "[textuel]"
**Mots à utiliser :**
**Mots à éviter :**
**Glossaire :**
| Terme | Signification |
|-------|---------------|
| | |

## Voix de marque
**Ton :**
**Style :**
**Personnalité :**

## Preuves
**Indicateurs :**
**Clients :**
**Témoignages :**
> "[citation]" — [qui]
**Thèmes de valeur :**
| Thème | Preuve |
|-------|-------|
| | |

## Objectifs
**Objectif commercial :**
**Action de conversion :**
**Indicateurs actuels :**

## Journal des modifications
*Du plus récent au plus ancien. Une ligne par révision : ce qui a changé et pourquoi.*
- v1 ([date]) — Contexte initial.

---

Étape 4 : Confirmer, versionner et enregistrer

• Affichez le document terminé.
• Demandez si des ajustements sont nécessaires.
• Définissez la version et le journal des modifications — c'est la piste de décision pour un document que toutes les autres compétences lisent :
  • Nouveau document : définissez Version du document : v1 et une seule entrée dans le journal des modifications : - v1 ([aujourd'hui]) — Contexte initial.
  • Mise à jour d'un document existant : incrémentez la version (v2 → v3 …), mettez à jour Dernière mise à jour à aujourd'hui, et ajoutez une nouvelle entrée au journal des modifications en haut de la liste (la plus récente en premier) résumant ce qui a changé et pourquoi en une ligne. Ne réécrivez ni ne réordonnez jamais les entrées passées.
  • Une bonne entrée nomme les sections touchées et la raison, pas « document mis à jour ». Exemples :
    • - v3 (2026-07-16) — Repositionné d'"outil email" à "plateforme de délivrabilité" ; ajouté RevOps à l'ICP.
    • - v2 (2026-06-02) — Réécrit la proposition de valeur et les objections après 5 entretiens clients ; ajouté le concurrent Acme.
  • Utilisez la date d'aujourd'hui au format ISO (AAAA-MM-JJ) pour l'entrée et Dernière mise à jour.
  • Correction purement typographique : n'incrémentez pas la version et n'ajoutez pas d'entrée au journal — enregistrez simplement la correction. Tout autre changement incrémente la version et obtient une entrée. Lorsque le changement est un véritable repositionnement, dites-le clairement — les compétences en aval généreront désormais sur la base du nouveau contexte.
• Enregistrez dans .agents/product-marketing.md.
• Dites-leur : « Les autres compétences marketing utiliseront désormais ce contexte automatiquement. Le journal des modifications en bas suit chaque révision — consultez-le pour voir comment votre positionnement a évolué. Exécutez /product-marketing à tout moment pour le mettre à jour. »

---

Conseils

• Soyez précis : Demandez « Quelle est la frustration numéro 1 qui les amène à vous ? » et non « Quel problème résolvent-ils ? »
• Capturez les mots exacts : Le langage client surpasse les descriptions polies.
• Demandez des exemples : « Pouvez-vous me donner un exemple ? » débloque de meilleures réponses.
• Validez au fur et à mesure : Résumez chaque section et confirmez avant de passer à la suivante.
• Sautez ce qui ne s'applique pas : Tous les produits n'ont pas besoin de toutes les sections (par exemple, Personas pour B2C).