discover-brand

ブランドの発見

企業プラットフォーム全体でブランド素材を自律的に発見できるよう調整します。このスキルは discover-brand エージェントと連携し、接続済みのプラットフォーム（Notion、Confluence、Google Drive、Box、Microsoft 365、Figma、Gong、Granola、Slack）を検索して情報源を振り分け、未解決の質問を含む構造化された発見レポートを作成します。

発見ワークフロー

0. ユーザーに概要を説明する

開始前に、これから何が行われるのかを簡潔に説明し、ユーザーが流れを把握できるようにします。

「ブランドの発見は次のように進みます。

1. 検索 — 接続済みのプラットフォーム（Notion、Google Drive、Slack など）を検索し、スタイルガイド、ピッチデッキ、テンプレート、トランスクリプトなど、ブランド関連の素材を探します。
2. 分析 — 見つかった情報を分類して順位付けし、有力な情報源を抽出して、見つかったもの、競合する情報、未解決の質問をまとめた発見レポートを作成します。
3. ガイドラインの生成 — レポートを確認していただいた後、結果をもとに構造化されたブランドボイスガイドラインのドキュメントを生成できます。
4. 保存 — 承認後、作業フォルダー内の .claude/brand-voice-guidelines.md にガイドラインを保存します。この段階まで、何も書き込まれません。

検索にかかる時間は、接続されているプラットフォームの数によって異なりますが、通常は数分です。始めてもよろしいですか？」

続行する前に、ユーザーの確認を待ちます。プロセスについて質問がある場合は、先に回答します。

1. 設定を確認する

.claude/brand-voice.local.md が存在する場合は読み込み、以下を抽出します。

• 会社名
• 有効になっているプラットフォーム（notion、confluence、google-drive、box、microsoft-365、figma、gong、granola、slack）
• 検索の深さの設定（standard または deep）
• ソースの最大数
• 「Known Brand Materials」に記載されている既知のブランド素材の場所

設定ファイルが存在しない場合は、接続済みのすべてのプラットフォームと標準の検索の深さを使用して続行します。

2. プラットフォームの対象範囲を検証する

対象範囲を確認する前に、実際に接続されているプラットフォームを確認し、分類します。

ドキュメントプラットフォーム（ブランドガイドライン、スタイルガイド、テンプレート、デッキが保存されている場所）：

• Notion、Confluence、Google Drive、Box、Microsoft 365（SharePoint/OneDrive）

補助プラットフォーム（傾向を把握するのに役立ちますが、ブランドドキュメントの保存先ではありません）：

• Slack、Gong、Granola、Figma

以下のルールを適用します。

1. ドキュメントプラットフォームが1つも接続されていない場合：停止します。 ユーザーに次のように伝えます。「ドキュメントストレージプラットフォーム（Google Drive、SharePoint、Notion、Confluence、Box）が接続されていません。ブランドガイドラインやスタイルガイドは、ほとんどの場合、これらのいずれかに保存されています。発見を実行する前に、少なくとも1つ接続してください。Gong/Granola/Slack のトランスクリプトは補助資料として役立ちますが、正式なブランドドキュメントが含まれている可能性は低いです。」

2. Google Drive、Microsoft 365、Box のいずれも接続されていない場合：警告します（ただし続行します）。「主要なファイルストレージプラットフォーム（Google Drive、SharePoint、Box）が1つも接続されていません。ブランドドキュメントは、これらのプラットフォームに保存されていることがよくあります。[接続済みのプラットフォーム]を使って発見を進めますが、結果に大きな不足が生じる可能性があります。Google Drive または SharePoint の接続をご検討ください。」

3. 接続済みのプラットフォームが合計1つだけの場合：警告します（ただし続行します）。「[プラットフォーム]のみが接続されています。複数の情報源を相互に検証できるよう、2つ以上のプラットフォームがあると発見の精度が高まります。単一のプラットフォームから得られる結果は、信頼度が低くなります。」

3. ユーザーに対象範囲を確認する

発見を開始する前に、以下を確認します。

• 検索するプラットフォーム（既定：接続済みのすべて）
• 会話のトランスクリプト（Gong、Granola）を含めるか、ドキュメントのみを対象にするか
• 優先する既知の場所

簡潔に、一連の質問ではなく1つの質問にまとめます。

4. Discover-Brand エージェントに委任する

Task ツールを使用して discover-brand エージェントを起動します。次の情報を渡します。

• 会社名（設定またはユーザー入力から取得）
• 有効なプラットフォーム
• 検索の深さ
• 最初に確認する既知の URL または場所

エージェントは、次の4段階の発見アルゴリズムを自律的に実行します。

1. 広範な発見 — 複数のプラットフォームを並行して検索
2. ソースの選別 — ソースを分類して順位付け
3. 詳細な取得 — 上位のソースを取得して内容を抽出
4. 発見レポート — 未解決の質問を含む構造化された出力

5. 発見レポートを提示する

エージェントから応答があったら、概要とともにレポートをユーザーに提示します。

• 発見して分析したソースの合計数
• 見つかった主要なブランド要素
• ソース間で矛盾している点
• チームからの回答が必要な未解決の質問

6. 次のステップを提案する

レポートの提示後、次の選択肢を提案します。

1. 今すぐガイドラインを生成する — 発見レポートを入力として /brand-voice:generate-guidelines に引き継ぐ
2. 先に未解決の質問を解決する — 生成前に優先度の高い質問に取り組む
3. レポートを保存する — 発見レポートを Notion またはローカルファイルに保存する
4. 検索を拡張する — 対象のプラットフォームを増やすか、検索をより深く行う（網羅性が低い場合）

未解決の質問

発見エージェントが解決できない曖昧さに遭遇すると、未解決の質問が生じます。

• 文書間の矛盾（例：2023年のスタイルガイドと2024年のブランド更新）
• 重要なセクションの欠落（例：ソーシャルメディアのガイドラインが見つからない）
• プラットフォーム間で用語が統一されていない

すべての未解決の質問には、エージェントの推奨事項が含まれます。質問は行き止まりとしてではなく、「確認または修正」する項目として提示します。

他のスキルとの連携

• ガイドライン生成：発見レポートは、Task ツールを介して discover-brand エージェントから返されます。ユーザーが手作業でソースを集める必要がないよう、構造化された入力としてレポートをガイドライン生成スキルに直接渡します。
• ブランドボイスの適用：発見結果をもとにガイドラインを生成すると、その後はガイドラインが自動的に適用されます。

エラー処理

• 接続済みのプラットフォームがない場合は、プラグインが対応しているプラットフォームと接続方法をユーザーに伝えます。
• すべての検索結果が空の場合は、発見の「網羅性が低い」と報告し、ユーザーに文書を手動で提供するか、プラットフォームの接続を確認するよう提案します。
• プラットフォームが接続されていても権限エラーが返された場合は、その不足を記録し、他のプラットフォームでの検索を続けます。

参考ファイル

詳細な発見パターンとアルゴリズムについては、以下を参照してください。

• references/search-strategies.md — プラットフォーム固有の検索クエリ、プラットフォーム別のクエリパターン、発見の網羅性を高めるヒント
• references/source-ranking.md — ソースカテゴリの定義、順位付けアルゴリズムの重み、選別の判断基準