guideline-generation

ガイドラインの生成

ブランドドキュメント、営業通話の文字起こし、ディスカバリーレポート、ユーザーからの直接入力など、あらゆる組み合わせの情報源から、LLM に対応した包括的なブランドボイスガイドラインを生成します。元の素材を、信頼度スコアと未解決の質問を含む、構造化され実行可能なガイドラインに変換します。

入力

以下の任意の組み合わせを受け付けます。

• ディスカバリーレポート：discover-brand スキルによるもの（構造化済み、事前にトリアージ済み）
• ブランドドキュメント：アップロードされたもの、または接続済みプラットフォームから取得したもの（PDF、PPTX、DOCX、MD、TXT）
• 会話の文字起こし：Gong、Granola、手動アップロード、Notion の会議メモ
• ブランドボイスや価値観に関するユーザーからの直接入力

ディスカバリーレポートが提供されている場合は、主な入力として使用します。情報源はすでにトリアージされ、順位付けされているため、必要に応じて追加分析で補完します。

生成ワークフロー

1. 情報源を特定して分類する

ユーザーが何を提供したかを判断します。情報源がない場合は、以下を行います。

• 以前の /brand-voice:discover-brand の実行によるディスカバリーレポートがあるか確認する
• 既知のブランド素材の場所について .claude/brand-voice.local.md を確認する
• まずディスカバリーを実行するよう提案する：/brand-voice:discover-brand

2. 情報源を処理する

ドキュメントの場合： 大量の解析はドキュメント分析エージェントに委任します。ボイスの属性、メッセージのテーマ、用語、トーンの指針、例を抽出します。

文字起こしの場合： パターン認識は会話分析エージェントに委任します。暗黙的なボイスの属性、効果的な言語パターン、状況に応じたトーン、避けるべきパターンを抽出します。

ディスカバリーレポートの場合： 事前にトリアージされた情報源、矛盾、ギャップを抽出します。順位付けされた情報源をそのまま使用します。

3. 統合してガイドラインにする

references/guideline-template.md のテンプレートに従って、すべての調査結果を統合したガイドラインドキュメントを作成します。主なセクションは以下のとおりです。

「私たちはこうである／こうではない」表 — ブランドアイデンティティの中核となる指針です。

私たちはこうである	私たちはこうではない
[属性 — 例：「自信に満ちている」]	[反対の属性 — 例：「傲慢」]
[属性 — 例：「親しみやすい」]	[反対の属性 — 例：「くだけすぎている、または雑」]

情報源全体で最も一貫して見られるパターンから属性を導き出します。各行には裏付けとなる証拠を示します。

ボイスの不変要素とトーンの調整要素 — 変わらないものと状況に応じて変わるものを明確にします。

• ボイス ＝ パーソナリティ、価値観、「私たちはこうである／こうではない」——すべてのコンテンツで一定
• トーン ＝ フォーマルさ、活気、専門性の深さ——状況に応じて調整

状況別トーンマトリックス：

状況	フォーマルさ	活気	専門性の深さ	例
初回の営業連絡	中	高	低	「[例文]」
エンタープライズ向け提案	高	中	高	「[例文]」
ソーシャルメディア	低	高	低	「[例文]」

4. 信頼度スコアを割り当てる

references/confidence-scoring.md の方法に従って、各セクションを評価します。

• 信頼度：高：裏付けとなる情報源が3つ以上あり、明示的な指針が見つかっている
• 信頼度：中：情報源が1～2つ、またはパターンから推測している
• 信頼度：低：単一の情報源、推測に基づく、またはデータに矛盾がある

5. 未解決の質問を提示する

解決できない曖昧さについて、未解決の質問を作成します。

## Open Questions for Team Discussion

### High Priority (blocks guideline completion)
1. **[Question Title]**
   - What was found: [conflicting or incomplete info]
   - Agent recommendation: [suggested resolution with reasoning]
   - Need from you: [specific decision or confirmation needed]

未解決の質問には、必ずエージェントの推奨事項を含めてください。曖昧さは「確認または上書き」できる形にし、行き止まりにしてはいけません。

6. 品質を確認する

提示する前に、品質保証エージェント（agents/quality-assurance.md で定義）を通じて、以下を確認します。

• 主要なセクションがすべて記入されている（情報源が裏付けている場合は、ブランドパーソナリティとコンテンツ例も含む）
• 証拠を伴うボイスの属性が3つ以上ある
• 「私たちはこうである／こうではない」表に4行以上ある
• トーンマトリックスが3つ以上の状況を網羅している
• セクションごとに信頼度スコアが割り当てられている
• 抽出したすべての要素に情報源が明記されている
• PII が露出していない
• 未解決の質問に推奨事項が含まれている

7. 結果を提示し、次のステップを提案する

主な結果を要約します：

• 生成されたセクションの総数と信頼度の内訳
• 最も強いボイス属性と最も効果的なメッセージ
• 未解決の質問の数（ある場合）

8. 今後のセッションのために保存する

デフォルトの保存先は、ユーザーの作業フォルダー内の .claude/brand-voice-guidelines.md です。

重要： エージェントの作業ディレクトリは、ユーザーのプロジェクトルートではない可能性があります（特に Cowork では、プラグインがプラグインキャッシュディレクトリから実行されます）。パスは常に、カレント作業ディレクトリではなく、ユーザーの作業フォルダーを基準に解決してください。作業フォルダーが設定されていない場合は、ファイルの保存をスキップし、ガイドラインはこの会話内でのみ利用可能になることをユーザーに伝えてください。

1. 保存パスを解決します。 ファイルは、ユーザーの作業フォルダー内の .claude/brand-voice-guidelines.md に保存する必要があります。書き込む前に作業フォルダーのパスを確認してください。
2. そのパスにガイドラインがすでに存在するか確認します
3. 存在する場合は、以前のバージョンをアーカイブします： 既存のファイルを、同じディレクトリ内で brand-voice-guidelines-YYYY-MM-DD.md にリネームします（今日の日付を使用）
4. 新しいガイドラインを保存します — 作業フォルダー内の .claude/brand-voice-guidelines.md に
5. ユーザーに確認します — 完全な絶対パスとともに：「ガイドラインを <full-path> に保存しました。/brand-voice:enforce-voice は今後のセッションで自動的にそれらを見つけます。」

ガイドラインはこの会話内にも存在するため、/brand-voice:enforce-voice はファイルから読み込むことなく、すぐにそれらを使用できます。

保存後、以下を提案します：

1. ガイドラインをセクションごとに順に確認する
2. /brand-voice:enforce-voice でコンテンツの作成を開始する
3. 未解決の質問を解決する

プライバシーとセキュリティ

出力時だけでなく、生成ワークフロー全体を通じて、以下のプライバシー制約を適用してください：

• すべての例から顧客名と連絡先情報を伏せ字にする
• 求められた場合は、文字起こしの抜粋に含まれる会社名を匿名化する
• 処理中に検出された機密情報にフラグを立てる

参照ファイル

• references/guideline-template.md — すべてのセクション、フィールド定義、書式設定のガイダンスを含む完全な出力テンプレート
• references/confidence-scoring.md — 信頼度スコアリングの方法論、しきい値、例