brand-context

ブランドコンテキスト

ブランドごとに brand-context.md ファイルを1つ作成し、維持します。これは、その事業が何を販売し、誰に販売し、どのような話し方をし、何を証明できるのかをまとめた唯一の信頼できる情報源です。このコレクション内のほかのスキルは、ユーザーにブランドについて質問する前にこのファイルを読み込むため、ユーザーはタスクごとではなく、一度だけ事業について説明すれば済みます。

これはハブ・アンド・スポーク型モデルのハブです。広告コピー、ブログ記事、コールドメール、ソーシャルコンテンツ、ランディングページの作成は、すべて同じポジショニングとブランドボイスを基盤とします。それらを1つの維持管理されるドキュメントにまとめることで、下流のすべてのスキルが十分な情報を得た状態で始まり、一貫性を保てます。

ファイルの契約。 ドキュメントは永続ストレージ内の安定したパス /files/<brand-slug>/brand-context.md に保存し、毎回同じパスで再利用します。一度作成したら、その場で更新してください。すでにファイルが存在する場合は、最初から作り直さないでください（ユーザーが選別した顧客の生の表現や実績を消してしまいます）。実行中にドキュメントを変更した場合は、Last updated の行を更新してください。

要件

• Hyper MCP に接続済みであること。 https://app.hyperfx.ai/mcp — ドキュメントを永続化するファイルツールと、自動ドラフト作成に必要です。
• 自動ドラフト作成に推奨。https://app.hyperfx.ai/apps で有効にしてください：Firecrawl（ブランドのサイトを読み込み、ビジュアルアイデンティティを抽出します）。利用できない場合は、自動ドラフト作成をスキップしてインタビューパスを使用してください。このスキルは引き続き動作します。
• 任意の情報補完： customer-research で使用される Apify スクレイパー（顧客の生の表現）と HyperSEO（競合状況）。どちらもあると便利ですが、実際のデータなしで作成したセクションは、内容を捏造せず、未検証として明記してください。

このスキルでツールを実行する方法

このスキルの各ツールには、正式なツール名が付いています。お使いの環境が提供する呼び出し方法で実行してください。

環境	ツールを探す	実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")、次に describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"、次に hyperai describe <name>	hyperai call <name> --json '{...}'

ツールが見つからない場合、その連携機能は接続されていないか、ワークスペースで有効になっていません。処理を中止し、ユーザーに接続すべき連携機能を伝えてください。

ツール一覧

作業	ツール
brand-context.md の読み取り、作成、更新	ファイルツール（read_file、create_file、edit_file）
ブランドのサイトから自動ドラフトを作成	firecrawl_urls_scrape（ホームページ、会社概要、料金、製品ページ）、フォールバックとして web_pages_scrape
ビジュアルアイデンティティ（色、ロゴ、タイポグラフィ）	firecrawl_branding_extract
顧客の生の表現（任意）	customer-research に委ねる
競合状況（任意）	competitor-intel、seo-research に委ねる

対象外：ほかのスキルに委ねる

依頼	依頼先
顧客の生の声を詳細に収集する（Reddit、レビュー、ソーシャル）	customer-research
競合の包括的な調査、バトルカード、モニタリング	competitor-intel
ブログのトピック戦略と公開済み記事のログ	blog-generation（その blog-strategy.md の ブランド概要 には、このドキュメントを基に情報を入力し、作り直さないでください）
画像生成用のブランド素材の抽出	ad-creative-generation（クリエイティブの作成時に firecrawl_branding_extract を使用）
キーワードまたは SERP の調査	seo-research

ドキュメント

セクションごとのガイダンスを含むテンプレート全体は、references/brand-context-template.md にあります。セクションは次の順です。

1. 製品概要 — 製品の内容、機能、カテゴリ、一文での説明。
2. ターゲットオーディエンス／ICP — 具体的な顧客、企業統計または人口統計、対象外となる人。
3. ペルソナ — 役割、きっかけ、成功基準を含む購入者／ユーザーのペルソナを2～4人分。
4. ペインポイント — 購入につながる問題を優先順位順に記載。
5. 競合環境 — 直接的・間接的な代替手段。「何もしない」／スプレッドシート／現状維持も含めます。
6. 差別化要因 — 顧客が各代替手段ではなくこのブランドを選ぶ理由、このブランドだけが主張できること。
7. 反論と乗り換え — 商談が停滞する理由、見込み客が懸念すること、乗り換えに伴うコスト。
8. 顧客の言葉 — 顧客自身の言葉で、問題や製品をどのように表現するかを示す逐語的な引用。このドキュメントで最も価値のあるセクションです。
9. ブランドボイス — トーン、読解レベル、視点、使用する言葉、使用禁止の言葉。
10. 実証ポイント — 実際の数値、顧客名、資格、データ。検証済みの項目のみを記載します。
11. 目標と現在の注力分野 — 今四半期にマーケティングで成果を上げようとしていること、優先チャネル。
12. アセットとチャネル — サイト URL、ブログ、ソーシャルアカウント、使用中の広告アカウント、ビジュアルアイデンティティに関するメモ。

ドキュメントの作成

ステップ 0：既存のドキュメントを確認します。 ブランドのパスと、妥当な旧来の保存場所に brand-context.md があるか確認してください。見つかった場合は更新として実行します。全文を読み、ユーザーが変更を希望するセクション、または新しい証拠と矛盾するセクションのみを修正してください。何も見つからない場合に限り、新規に作成します。

パス A — 自動下書き（ブランドのウェブサイトがある場合のデフォルト）。

1. サイト URL が不明な場合は、ユーザーに尋ねます。
2. firecrawl_urls_scrape を使って、重要なページをスクレイピングします。ホームページ、概要、料金、製品／機能ページを1～2ページ、存在する場合はお客様の声や事例紹介を掲載した顧客向けページを対象とします。
3. 必要に応じて firecrawl_branding_extract を1回呼び出し、セクション12のビジュアルアイデンティティに関するメモを補います。
4. 実際の証拠があるセクションをすべて下書きします。サイトに記載がない内容（反論、目標、顧客の言葉の大半など）は、推測せずに *(未検証 — 入力が必要)* と記します。
5. 保存する前に、修正してもらうため、セクションごとに下書きをユーザーに提示します。 サイトが示すのはブランドが「真実であってほしい」と考えていることであり、「実際に」真実であることはユーザーが知っています。特に、ICP（「実際に購入するのは誰か？」）、差別化要因（「Xではなくあなたを選ぶのはなぜか？」）、実証ポイント（「この数値のうち、実際の最新のものはどれか？」）について尋ねてください。
6. /files/<brand-slug>/brand-context.md に保存し、パスを報告します。

パス B — インタビュー（サイトがない、ローンチ前、またはユーザーが会話を希望する場合）。 references/brand-context-template.md に記載された順に、セクションごとに会話形式で進めます。一度に質問するのは数問ずつとし、長大な質問票をまとめて提示しないでください。まず製品概要とICPから始めます（ほかのすべてはここが基盤になります）。また、ユーザーがセクションを飛ばせるようにします。内容を水増しした完全なドキュメントより、正直な部分的ドキュメントのほうが優れています。途中でインタビューが中断しても使えるドキュメントが残るよう、段階的に保存してください。

どちらのパスでも、保存前に： 以下の品質チェックを実行してください。

品質ゲート

• どこでも捏造しないでください。 顧客の引用、統計、競合に関する主張、ペルソナの詳細を決して作り上げないでください。「入力が必要」と記された空のセクションは正しい状態です。もっともらしく作り上げた内容は有害であり、後続のスキルがそれを広告やメールで自信たっぷりに繰り返すことになります。
• 逐語引用は一字一句そのままです。 顧客の言葉は、顧客が話した、または書いたとおりに正確に引用し、出典（レビュー、通話、Reddit のスレッド）を記載します。洗練した言い換えはポジショニングに記載し、セクション 8 には記載しません。
• 完全さより具体性を重視します。 「配送業者のスプレッドシートに追われる、従業員 20～200 人の E コマースブランドのオペレーション管理者」は有用ですが、「時間を節約したい企業」は埋め草です。埋め草は削除してください。
• 実績を裏付ける情報は検証済みのものに限ります。 ユーザーが確認した数字と名称だけを使います。日付を付けてください（「2026 年 6 月時点で顧客 2,400 社」）。
• 一言での説明は、初めて聞く人にも伝わるか確認します。 カテゴリー、対象者、主要な価値を、初めて聞く人が繰り返せる一文にまとめます。

他のスキルによるこのドキュメントの利用方法（スポークの取り決め）

マーケティングスキルがブランドの背景情報（ポジショニング、対象者、トーン、実績を裏付ける情報）を必要とする場合：

1. ユーザーにブランドについて質問する前に、まず /files/<brand-slug>/brand-context.md にある brand-context.md を確認してください。 ファイルが存在する場合は全文を読み、タスクに必要で、ドキュメントに記載されていない情報だけを尋ねてください。
2. ボイスのセクションを遵守してください。 使用する言葉／使用しない言葉のリストは、生成するコピーに対する厳守事項です。
3. 顧客の言葉からフックを引き出してください。 セクション 8 の逐語表現は、作り上げたコピーよりも効果的です。見出し、件名、書き出しには、できるだけそれらを使ってください。
4. セクション 10 にない実績を裏付ける情報は、決して引用しないでください。 主張を裏付ける情報がドキュメントにない場合、コピーではその主張をしません。
5. 情報の鮮度を確認してください。 Last updated が約 6 か月以上前の場合は、その旨を伝えて更新を提案します。ただし、タスクの途中で黙ってドキュメントを作り直してはいけません。
6. ドキュメントへの書き戻しはしないでください。 スポークは読み取り専用です。書き込むのはこのスキルだけで、ユーザーと一緒に行います。タスク中にドキュメントに追加すべき内容（優れた顧客の引用、新たな競合など）が見つかった場合は、ユーザーに brand-context を実行して追加するよう提案してください。

ドキュメントのメンテナンス

ドキュメントは随時更新されます。ポジショニングの変更、新たに重要な競合の出現、価格の変更、または調査（customer-research／competitor-intel による）で、より優れた引用や市場データが得られた場合は更新してください。更新時は、まず読み、変更があった箇所だけを編集し、ユーザーが整えた内容をすべて維持し、Last updated を更新して、差分の概要をユーザーに伝えてください。複数のブランドがある場合は、ブランドごとに別の <brand-slug> ディレクトリにドキュメントを 1 つずつ置き、1 つのファイルに複数のブランドを混在させないでください。

参考資料

• references/brand-context-template.md：コピーして使える完全なドキュメントテンプレート、各セクションの内容を充実させるためのガイダンス、Path B 用のインタビュー質問集です。