developer-audience-context

開発者オーディエンスのコンテキスト

このスキルは、ターゲットとする開発者についての情報をまとめた基礎文書 .agents/developer-audience-context.md の作成とメンテナンスに役立ちます。他のすべての開発者向けマーケティングスキルは、まずこの文書を参照するため、オーディエンスを定義するのは一度だけで済みます。

---

始める前に

.agents/developer-audience-context.md が存在するか確認します。

• 存在する場合：内容を読み、特定のセクションを更新するか尋ねます
• 存在しない場合：ディレクトリとファイルを作成し、各セクションの内容を順に確認します

---

コンテキストを作成する2つの方法

オプション1：コードベースから自動で下書きを作成する（推奨）

既存の資料を分析して、初期バージョンの下書きを作成します。

1. README.md — 製品の説明、機能、利用開始方法
2. ドキュメント — /docs、API リファレンス、チュートリアル
3. ランディングページ — index.html、マーケティング文
4. package.json / pyproject.toml — 依存関係からエコシステムを把握
5. GitHub Issues — よくある質問、不満、ユースケース
6. 既存のブログ記事 — 技術コンテンツ、チュートリアル

下書きを作成したら、各セクションの内容を確認し、不足を補います。

オプション2：ゼロから始める

セクションごとに質問します。現在のセクションが完了するまで、次に進まないでください。

---

把握する10のセクション

1. 製品の概要

項目	把握する内容
製品名	正式名称と別名
一言での説明	「[開発者]が[Y]をせずに[X]できるよう支援します」
カテゴリ	API、SDK、CLI、SaaS、オープンソースライブラリ、インフラストラクチャ
コア技術	対応する言語、フレームワーク、プラットフォーム
料金モデル	無料／オープンソース、フリーミアム、使用量ベース、席数ベース

2. 開発者のペルソナ

漠然とした「開発者」ではなく、具体的に把握します。

項目	把握する内容
主な職種	バックエンド、フロントエンド、フルスタック、DevOps、データ、機械学習、モバイル
経験レベル	ジュニア、ミッドレベル、シニア、スタッフ、リード、アーキテクト
企業規模	個人、スタートアップ、スケールアップ、エンタープライズ
業界分野	フィンテック、ヘルステック、eコマース、ゲーム、B2B SaaS
技術スタック	使用している言語、フレームワーク、クラウドプロバイダー
意思決定権限	個人貢献者、チームリード、購入担当者、インフルエンサー

質問：「製品から最も価値を得る開発者について、1段落で説明してください。その人の日常はどのようなものですか？」

3. 開発者が集まる場所

開発者は購入前に調査します。どこで情報を集めているか把握します。

チャネル	具体的に把握する内容
コミュニティ	具体的なサブレディット、Discord サーバー、Slack グループ
ソーシャルメディア	Twitter/X のハッシュタグ、LinkedIn グループ
コンテンツ	読んでいるブログ、購読しているニュースレター、ポッドキャスト
イベント	カンファレンス、ミートアップ、ハッカソン
コード	GitHub のトピック、Stack Overflow のタグ

ヒント：ソーシャルリスニングツールを使って、Hacker News、Reddit、Stack Overflow、GitHub、Twitter での会話をモニタリングしましょう。課題領域についての議論が自然に行われている場所を探します。

4. 問題と悩み

自社ソリューションの機能ではなく、実際の問題を把握します。

レベル	把握する内容
機能面	「Xができない」／「Xに時間がかかりすぎる」／「Xはエラーが起こりやすい」
感情面	いらだち、不安、気まずさ、恐れ
状況面	どんなときに問題が起きますか？何がきっかけで検索しますか？

質問：「開発者があなたのところに来る、最も大きな不満は何ですか？」

調査：Reddit、Hacker News、Stack Overflow で、自社の課題領域に関する不満を検索します。実際の引用を記録します。

5. 現在使われている代替手段

開発者は現在、あなたの製品の代わりに何を使っていますか？

代替手段の種類	例
直接的な競合	同じ問題を解決するツール
DIY／自作	カスタムスクリプト、社内ツール
間接的な解決策	回避策、手作業のプロセス
何もしない	問題を抱えたままにする

代替手段ごとに、次の内容を把握します。

• 開発者がそれを選ぶ理由
• どんな点に不満を感じているか
• どんなことがあれば乗り換えるか

6. 主な差別化要因

開発者の視点で、他と何が違うのかを示します。

差別化要因の種類	例
技術面	「10倍高速」「依存関係なし」「型安全」
DX（開発者体験）	「5分でセットアップ」「優れたドキュメント」「一流のCLI」
エコシステム	「Xと連携」「Yフレームワーク向けに構築」
哲学	「オープンソース」「プライバシー最優先」「ローカル優先」

警告：宣伝文句ばかりにならないようにしてください。開発者は「クラス最高」や「エンタープライズ級」といった表現を見抜きます。具体的で、立証可能な主張を使いましょう。

7. 開発者が実際に使う言葉

洗練された宣伝文ではなく、開発者が実際に使う表現をそのまま記録します。

カテゴリー	例
問題の説明	「これは本当に面倒」「これさえできればいいのに……」
製品の説明	他の人にどのように説明しているか
懸念事項	「でも、……はどうなるの？」「……が心配です」
称賛	お客様の声、ツイート、GitHub のコメント

情報源：GitHub の Issue、Twitter での言及、Hacker News のコメント、サポートチケット、営業電話、コミュニティの Slack／Discord。

8. 技術的な信頼性を示す情報

開発者にとって重要な証拠を示します。

シグナルの種類	例
採用状況	GitHub スター数、npm のダウンロード数、Docker のプル数
品質	テストカバレッジ、セキュリティ監査、稼働率 SLA
コミュニティ	コントリビューター数、Discord のメンバー数、フォーラムの活動状況
信頼性	X の支援を受けている、Y に利用されている、Z が作成した
透明性	オープンソース、公開ロードマップ、変更履歴

9. コンバージョンにつながるアクション

各段階での成功とは、どのような状態でしょうか？

段階	主なアクション	副次的なアクション
認知	リポジトリにスターを付ける、Twitter をフォローする	ブログ記事を読む、コンテンツを共有する
検討	リポジトリをクローンする、ドキュメントを読む	デモを見る、Discord に参加する
試用	サインアップする、SDK をインストールする	クイックスタートを完了する、最初の API 呼び出しを行う
利用開始	「Hello World」を実行する	実際のプロジェクトに統合する
コンバージョン	有料プランにアップグレードする	チームメンバーを追加する、利用範囲を拡大する

10. 語り口とトーン

対象となる開発者に対して、どのような語り口で接するべきでしょうか？

観点	方向性
フォーマルさ	カジュアル ← → プロフェッショナル
技術性	わかりやすい ← → 高度に技術的
個性	中立的 ← → 明確な意見を持つ
ユーモア	真面目 ← → 遊び心がある

例：

• Stripe → プロフェッショナル、正確、すっきり
• Vercel → モダン、自信に満ちた、開発者第一
• Supabase → 親しみやすい、わかりやすい、コミュニティ重視
• Tailwind → 明確な意見を持つ、率直、実用的

---

出力形式

次の構成で .agents/developer-audience-context.md に保存します。

# Developer Audience Context

Last updated: [DATE]

## Product Overview
[Section content]

## Developer Persona
[Section content]

## Where They Hang Out
[Section content]

## Problems & Pain Points
[Section content]

## Current Alternatives
[Section content]

## Key Differentiators
[Section content]

## Verbatim Developer Language
[Section content]

## Technical Trust Signals
[Section content]

## Conversion Actions
[Section content]

## Voice & Tone
[Section content]

---

メンテナンス

次の場合に、このドキュメントを更新します。

• ユーザー調査から新しい知見を得たとき
• 優れた引用を見つけたとき
• ポジショニングや差別化要因が変わったとき
• 新しい開発者セグメントに対象を広げたとき

---

ツール

ツール	使用例
Octolens	GitHub、Hacker News、Reddit、Stack Overflow、Twitter 全体で開発者の会話をモニタリングします。実際の表現を記録し、課題を見つけ、開発者がどこに集まっているかを把握するうえで不可欠です。
GitHub Search	Issue で開発者が問題をどう説明しているかを見つけます
Twitter Advanced Search	自社の領域に関する議論を見つけます
Google Alerts	競合他社への言及や、問題に関するキーワードを追跡します

---

関連スキル

コンテキストを確立すると、次のスキルで参照されます。

• devrel-content — 共感を呼ぶコンテンツの作成
• hacker-news-strategy — HN で誠実に交流する
• developer-onboarding — 価値実現までの時間を最適化する
• developer-seo — 適切な技術系検索クエリを対象にする
• competitor-tracking — 競争環境を理解する