product-marketing

製品マーケティングコンテキスト

ユーザーが製品マーケティングコンテキストドキュメントを作成・維持するのを支援します。これは、他のマーケティングスキルが参照する基盤となるポジショニングとメッセージングの情報をまとめたもので、ユーザーが同じ説明を繰り返さずに済みます。

ドキュメントは .agents/product-marketing.md に保存されます。

ワークフロー

ステップ 1: 既存のコンテキストを確認する

まず、.agents/product-marketing.md がすでに存在するかどうかを確認します。あわせて .claude/product-marketing.md と、旧来のファイル名である product-marketing-context.md（.agents/ または .claude/ のいずれか）も、古いセットアップのために確認してください。.agents/product-marketing.md 以外の場所で見つかった場合は、正規の場所へ移動することを提案します。

存在する場合:

• 内容を読み、何が記載されているかを要約します。現在の Document version と直近の Changelog エントリをいくつか示して、ユーザーがドキュメントの現状と最近の変更点を把握できるようにします
• どのセクションを更新したいかを尋ねます
• それらのセクションの情報だけを集めます
• 実質的な保存を行うたびに、バージョンを上げて changelog エントリを追加します（ステップ 4 を参照）。このドキュメントは他のすべてのマーケティングスキルが読み込む共有コンテキストであるため、何がいつ、なぜ変わったのか を示す日付入りの記録を残す価値があります。

存在しない場合は、2 つの選択肢を提示します:

1. コードベースからの自動ドラフト作成（推奨）: リポジトリ—README、ランディングページ、マーケティングコピー、package.json など—を調査し、コンテキストドキュメントの V1 をドラフトします。その後、ユーザーがレビューし、修正し、不足を補います。これはゼロから始めるよりも速い方法です。

2. ゼロから始める: 各セクションを会話形式でたどり、一度に 1 セクションずつ情報を集めます。

ほとんどのユーザーは選択肢 1 を好みます。ドラフトを提示した後、次のように尋ねます:「修正が必要な点はどこですか？ 不足しているものは何ですか？」

ステップ 2: 情報を集める

自動ドラフト作成の場合:

1. コードベースを読みます: README、ランディングページ、マーケティングコピー、about ページ、メタディスクリプション、package.json、既存のドキュメント
2. 見つけた内容に基づいてすべてのセクションをドラフトします
3. ドラフトを提示し、修正が必要な点や不足している点を尋ねます
4. ユーザーが満足するまで繰り返します

ゼロから始める場合: 以下の各セクションを会話形式で、一度に 1 つずつたどります。すべての質問を一度に投げかけないでください。

各セクションについて:

1. 何をまとめようとしているのかを簡単に説明します
2. 関連する質問をします
3. 正確さを確認します
4. 次のセクションに進みます

顧客の言葉をそのまま引き出すよう努めてください。正確なフレーズは、磨き上げられた説明よりも価値があります。なぜなら、顧客が実際にどう考え、どう話すかを反映しており、それによってコピーの訴求力が高まるからです。

---

まとめるべきセクション

1. 製品概要

• 一行での説明
• 何をするか（2〜3 文）
• 製品カテゴリ（どの「棚」に置かれるか—顧客がどうやってあなたを探すか）
• 製品タイプ（SaaS、マーケットプレイス、Eコマース、サービスなど）
• ビジネスモデルと価格設定

2. ターゲットオーディエンス

• ターゲット企業のタイプ（業界、規模、ステージ）
• ターゲットの意思決定者（役割、部門）
• 主なユースケース（あなたが解決する主な課題）
• Jobs to be done（顧客があなたを「採用」する 2〜3 の理由）
• 具体的なユースケースやシナリオ

3. ペルソナ（B2B のみ）

購入に複数のステークホルダーが関与する場合、それぞれについてまとめます:

• ユーザー、チャンピオン、意思決定者、財務上の購入者、技術的な影響力を持つ人
• それぞれが何を重視するか、その課題、そしてあなたが約束する価値

4. 課題とペインポイント

• 顧客があなたを見つける前に直面している中核的な課題
• 既存のソリューションがなぜ不十分なのか
• それが顧客に何を犠牲にさせるか（時間、お金、機会）
• 感情的な緊張（ストレス、恐れ、疑念）

5. 競合環境

• 直接競合: 同じソリューション、同じ課題（例: Calendly 対 SavvyCal）
• 二次競合: 異なるソリューション、同じ課題（例: Calendly 対 Superhuman のスケジューリング）
• 間接競合: 相反するアプローチ（例: Calendly 対 個人アシスタント）
• それぞれが顧客にとってどのように不十分なのか

6. 差別化

• 主な差別化要因（代替手段に欠けている機能）
• どのように違う形で解決するか
• なぜそれがより優れているのか（メリット）
• なぜ顧客が代替手段ではなくあなたを選ぶのか

7. 反論とアンチペルソナ

• 営業でよく聞く上位3つの反論と、その対処方法
• 適合しない顧客（アンチペルソナ）

8. 乗り換えの動因

JTBDの4つの力：

• プッシュ：現在のソリューションから離れるきっかけとなる不満
• プル：あなたのソリューションに惹かれる理由
• 習慣：現在の方法を続けてしまう理由
• 不安：乗り換えについて心配していること

9. 顧客の言葉

• 顧客が問題をどのように説明するか（原文のまま）
• 顧客があなたのソリューションをどのように説明するか（原文のまま）
• 使用する言葉やフレーズ
• 避ける言葉やフレーズ
• 製品固有の用語集

10. ブランドボイス

• 3〜5個のボイス属性。それぞれについて、意味すること、意味しないこと、既存のコピーからの実例を記載
• 文脈ごとのトーン：サポート、ローンチ、エラー、営業、ソーシャルでのボイスの変化
• ブランド用語：自社独自の用語、使わない言葉（その理由も記載）

会議で選んだ形容詞ではなく、すでに成果を上げたコピーと創業者自身の文章をもとに作成してください。抽出手順、記入例、修正前後の例、担当者ごとのボイスガイドについては、references/brand-voice.mdを参照してください。

11. 根拠となる実績

• 取り上げるべき主要な指標や成果
• 注目すべき顧客やロゴ
• お客様の声からの抜粋
• 主な価値のテーマと、それを裏付ける根拠

12. 目標

• 主要なビジネス目標
• 主要なコンバージョンアクション（ユーザーに実行してほしいこと）
• 現在の指標（分かる場合）

13. 有料広告（任意。広告を出稿している場合のみ）

adsスキルはこの情報を読み込むため、ユーザーはセッションごとにアカウントの説明を繰り返す必要がありません。

• 利益率の実情：ビジネスの収益性を保つ目標CPAまたはROASと、直ちに警告すべき下限（ROASが下回った場合、またはCPAが上回った場合に警告する値）
• 予算とペース配分：月間予算と許容できる日次の変動幅
• コンバージョンの基準：コンバージョンとして数えるアクションとそれぞれの価値、既知のトラッキング上の弱点（遅延、二重計上、オフラインデータの欠落）、良質なリードとフォーム入力だけのリードを区別する条件
• キャンペーンの命名規則と各キャンペーンの目的（それぞれ1行）
• エージェントが実行してよいこと（閲覧、比較、警告、下書き作成、提案）と、承認なしに実行してはならないこと（予算や入札単価の変更、一時停止や開始、トラッキングの編集、広告の公開）

14. 学び

まずは空欄のままにします。作業を進めて成果を公開するにつれて内容が蓄積されます（下記の「学びの維持」を参照）。

---

ステップ3：ドキュメントを作成する

情報を集めたら、.agents/product-marketing.mdを次の構成で作成します。

# Product Marketing Context

**Document version:** v1
**Last updated:** [date]

## Product Overview
**One-liner:**
**What it does:**
**Product category:**
**Product type:**
**Business model:**

## Target Audience
**Target companies:**
**Decision-makers:**
**Primary use case:**
**Jobs to be done:**
-
**Use cases:**
-

## Personas
| Persona | Cares about | Challenge | Value we promise |
|---------|-------------|-----------|------------------|
| | | | |

## Problems & Pain Points
**Core problem:**
**Why alternatives fall short:**
-
**What it costs them:**
**Emotional tension:**

## Competitive Landscape
**Direct:** [Competitor] — falls short because...
**Secondary:** [Approach] — falls short because...
**Indirect:** [Alternative] — falls short because...

## Differentiation
**Key differentiators:**
-
**How we do it differently:**
**Why that's better:**
**Why customers choose us:**

## Objections
| Objection | Response |
|-----------|----------|
| | |

**Anti-persona:**

## Switching Dynamics
**Push:**
**Pull:**
**Habit:**
**Anxiety:**

## Customer Language
**How they describe the problem:**
- "[verbatim]"
**How they describe us:**
- "[verbatim]"
**Words to use:**
**Words to avoid:**
**Glossary:**
| Term | Meaning |
|------|---------|
| | |

## Brand Voice
| Attribute | Means | Doesn't mean | Example line |
|-----------|-------|--------------|--------------|
| | | | |

**Tone by context:**
- Support:
- Launch:
- Errors:
- Sales:
- Social:
**Terms we own:**
**Never use (and why):**

## Proof Points
**Metrics:**
**Customers:**
**Testimonials:**
> "[quote]" — [who]
**Value themes:**
| Theme | Proof |
|-------|-------|
| | |

## Goals
**Business goal:**
**Conversion action:**
**Current metrics:**

## Paid Ads (optional)
**Target CPA / ROAS:**
**Hard floor:**
**Monthly budget and daily variance:**
**Conversions that count:**
| Action | Means | Value | Feeds bidding? |
|--------|-------|-------|----------------|
| | | | |
**Known tracking weaknesses:**
**Good lead vs. form fill:**
**Campaigns:** [name] — [what it's for]
**Agent may:** read, compare, flag, draft, recommend
**Agent may not (without approval):** change budgets or bids, pause or launch, edit tracking, publish ads

## Learnings
*Decisions and tested lessons. Newest first. Keep it to about 20 active entries.*
| Date | Learning | Evidence | Applies to | Status |
|------|----------|----------|------------|--------|
| | | | | |

## Changelog
*Newest first. One line per revision: what changed and why.*
- v1 ([date]) — Initial context.

---

ステップ 4：確認、バージョン設定、保存

• 完成したドキュメントを表示します
• 調整が必要な箇所がないか尋ねます
• バージョンと変更履歴を設定します — これは、ほかのすべてのスキルが参照するドキュメントの記録です。
  • 新規ドキュメント： Document version: v1 を設定し、変更履歴に次の項目を1件だけ追加します — - v1 ([today]) — 初期コンテキスト。
  • 既存ドキュメントの更新： バージョンを繰り上げ（v2 → v3 …）、Last updated を今日の日付に更新し、変更履歴の先頭に、何を、なぜ変更したかを1行でまとめた新しい項目を追加します（新しい順）。過去の項目を書き換えたり、並べ替えたりしないでください。
  • 適切な項目には、変更したセクションとその理由を記載します。「ドキュメントを更新」のような記述は避けてください。例：
    • - v3 (2026-07-16) — 「メールツール」から「配信到達性プラットフォーム」へ再定位し、ICP に RevOps を追加。
    • - v2 (2026-06-02) — 5 件の顧客インタビューを受けて価値提案と反論への対応を書き直し、競合の Acme を追加。
  • 変更履歴の項目と Last updated には、今日の日付を ISO 形式（YYYY-MM-DD）で使用します。
  • 誤字のみの修正： バージョンを繰り上げたり、変更履歴に項目を追加したりせず、修正を保存するだけにします。それ以外の変更では、バージョンを繰り上げて変更履歴に項目を追加します。実質的な再定位を行う場合は、その旨を明確に記載します。後続のスキルは新しいコンテキストに基づいて生成するようになります。
• .agents/product-marketing.md に保存します
• 次のように伝えます：「ほかのマーケティングスキルは、このコンテキストを自動的に使用するようになります。末尾の変更履歴にはすべての改訂が記録されるため、ポジショニングの変化を確認できます。更新するときは、いつでも /product-marketing を実行してください。」

---

学びの記録と管理

変更履歴には、ドキュメントの変更内容を記録します。学びには、実際に施策を実施してチームが得た知見、つまり効果があった訴求、成果が出なかったオファー、そしてその理由とともに下された決定を記録します。ドラフトを作成するスキル（コピーライティング、メール、広告、広告クリエイティブ、ソーシャル）は、執筆前にこれを参照し、次のブリーフに既知の知見を反映します。

項目の形式： 学び1件につき1行。

• 学び： ドラフトの内容を変えるのに十分な具体性を備えた1文にします。「価格を基準にした見出しは、価格ページで成果を訴求する見出しより効果が高い」は適切です。「もっと明確にする」では不十分です。
• 根拠： テスト、キャンペーン、または情報源を、数値とサンプルサイズとともに記載します。「バリアント B はトライアル開始数が 18％増加。各群 2,400 人の訪問者、3 週間。」
• 適用先： 影響するチャネル、セグメント、またはスキルを記載します。
• ステータス： active、watch（データポイントが1つあり、再テストする価値がある）、または retired を指定します。

記録する内容：

• 計画したサンプル数に達したテスト結果、または2件以上のキャンペーンで同じ傾向が見られた場合
• 理由を伴ってユーザーが下した決定（ポジショニング、価格設定、チャネルの削減など）で、今後のドラフトでも守る必要があるもの
• ユーザーから複数回指摘された修正（「プラットフォームとは呼ばないで」など）

記録しない内容： 1回だけの逸話（watch として記録するか、省略します）、タスクのメモ、別のセクションに記載すべき内容。新たな反論は「反論」に、新たな顧客の言い回しは「顧客の言葉」に記載します。

項目を終了するタイミング： 後続のテストで否定された場合、製品や市場の状況が変わった場合（新しい価格設定、新しい ICP など）、または2四半期にわたって関連性がなかった場合です。削除するのではなく、ステータスを retired に変更し、その理由を1行追加します。これにより、すでに結論が出た問題を再テストすることを防ぎます。終了した行は末尾に移動し、表に有効な行が約20件を超えたらアーカイブします。

記入する人： テスト、キャンペーン、または振り返りを完了したスキルは、行の追加を提案できます。提案する行をユーザーに提示し、承認されたら、ほかの実質的な変更と同様にバージョンを繰り上げ、変更履歴に項目を追加して記録します。スケジュールに従って実行されるループでは、セッション終了時のステップでこれを行います（marketing-loops を参照）。

---

ヒント

• 具体的に尋ねる：「彼らがあなたのもとを訪れる一番の不満は何ですか？」と尋ね、「彼らはどんな問題を解決しますか？」とは尋ねません
• 正確な言葉を記録する：顧客の言葉は、洗練された説明よりも価値があります
• 例を尋ねる：「例を挙げてもらえますか？」と尋ねることで、より良い回答を引き出せます
• 進めながら確認する：各セクションを要約し、次に進む前に確認します
• 当てはまらない項目は省略する：すべての製品にすべてのセクションが必要なわけではありません（例：B2C ではペルソナ、広告を出していない場合は有料広告）