business-brain

ビジネスブレインパターン

このスキルは、AI コーディングアシスタント向けに「ビジネスブレインパターン」を実装します。共有するビジネス知識とブランド知識をすべて 1 か所、つまり「ブレイン」に集約し、個々のスキルやエージェントからの問い合わせが、知識を重複させずに必要な部分だけを参照できるようにします。

問題

ブランドガイド、オーディエンスのプロファイル、ポジショニング資料の全内容をすべてのスキルやプロンプトに読み込むと、コンテキストウィンドウが肥大化します。トークンの使用量が増え、エージェントの注意が実際のタスク指示からそれてしまうほか、ブランドガイドラインが変更されたときのメンテナンスが非常に煩雑になります。

解決策

ビジネスブレインパターンでは、個々のスキルのプロンプトを簡潔に保ちます。各スキルは、実際に使用するブレインのセクションだけを読み込みます。ブレインは、トピックごとに分割されたモジュール式のファイルで構成されます。

使い方

ブランドに関するコンテキストの取得、ブランドに沿ったコピーの作成、またはプロジェクトのオーディエンスに関する質問への回答を求められた場合：

1. ローカルブレインを確認します： プロジェクトのワークスペースに .agent/brain/ ディレクトリがあるか確認します（または、旧形式の brain/、.claude/brain/、.gemini/brain/ を確認します）。
2. 必要なものだけを読み込みます： ファイル読み取りツールを使い、タスクに必要な特定のファイルだけを読み込みます。
   • 例：ソーシャルメディアの投稿案を作成するタスクでは、brand-voice.md と audience-profiles.md だけが必要な場合があります。
   • 例：技術仕様書を作成するタスクでは、content-rules.md だけが必要な場合があります。
3. コンテキストの一部だけが必要な場合、ブレインディレクトリ全体を読み込まないでください。モジュール式の構成を活用してください。

初期化

ユーザーがプロジェクト用の新しいビジネスブレインを設定したい場合は、付属のスキャフォールディングスクリプトを実行してテンプレートファイルを生成します：

bash ~/.agents/skills/business-brain/scripts/init-brain.sh

(エージェント環境によってパスは異なる場合があります。例：~/.claude/skills/ や ~/.gemini/skills/)

このスクリプトは、次のテンプレートを含む .agent/brain/ ディレクトリを作成します：

• brand-voice.md
• audience-profiles.md
• positioning.md
• content-rules.md

ブレインの構成

適切に構築されたビジネスブレインは、単なるデータの寄せ集めではありません。構造化され、要点をすばやく把握できる形式になっています：

brand-voice.md

• 文の長さに関する好みを指定します。
• 文体（自分を指す一人称、フォーマルな「私たち」、会話調の「私」）を定義します。
• 必ず使う言葉や表現と、使ってはいけない言葉や表現を列挙します。
• トーンの活気の度合いを説明します。
• ブランドの声を示す例文を 2～3 段落と、ブランドイメージに合わない文章の例を含めます。

audience-profiles.md

• 主要なオーディエンスのセグメントを 2～4 つ定義します。
• 職種や生活状況。
• 最も重視することと、懐疑的に捉えていること。
• トピックに関する知識レベル。
• 共感を得られる言葉遣いや伝え方。

positioning.md

• 会社や製品が提供するもの。
• 対象となる人。
• 代替手段ではなく選ばれる理由。
• 主張しないことを明確に記載します。内容を絞り込みます（200～300 語）。

content-rules.md

• 出力形式ごとの構成に関する好み。
• 見出しの書式に関するルール。
• リストと文章のどちらを優先するか。
• 長さの目安。
• 行動喚起の扱い方。

Agentic OS との統合

現在のプロジェクトルートに .agent/ ディレクトリがある場合、このスキルは Agentic OS の共有メモリモデルに必ず参加しなければなりません。

実行の最後に .agent/state/last-run.json があるか確認します。存在する場合は、所定のスキーマに従ってファイルに追記または更新し、実行内容を記録します。実行環境（agent_id）、assigned_skill、簡潔な description、decision_log、outcome を必ず記録してください。キューからタスクを完了する場合は、python3 ~/.agents/skills/heartbeat/scripts/heartbeat.py complete <task_id> ... を使用します。