agency-dashboard

/digital-marketing-pro:agency-dashboard

スクリプトの場所。 ホストが ${CLAUDE_PLUGIN_ROOT} を設定しない場合、スクリプトはこのプラグインの skills/ と同じ階層にある scripts/ フォルダーにあります。Python 3.10 以降で実行してください。python が見つからない場合は、python3 を使用してください（macOS、多くの Linux システム）。

目的

すべてのクライアントブランドの健全性指標を集約した、ポートフォリオ全体のダッシュボードを生成します。キャンペーンの状況、予算の消化状況、KPI の達成状況、コンテンツの進捗状況、チームの稼働状況をひと目で確認できるため、代理店のリーダーは各アカウントを個別に開かずに運営状況を把握できます。毎日のスタンドアップ、週次の代理店レビュー、または必要に応じた健全性チェック向けに設計されています。

必要な入力

ユーザーは次の項目を指定する必要があります（または、入力を求められます）。

• ダッシュボードの対象範囲：ポートフォリオビューに含めるすべてのブランド、または特定のブランドスラッグのリスト
• 期間：今週、今月、または今四半期。ペース計算と比較期間を決定します
• 詳細レベル：概要（クライアントごとの健全性スコアの要約）または詳細（各クライアントのキャンペーン単位の内訳と個別のキャンペーン指標）
• 並べ替え／フィルター設定：健全性スコア、支出、収益、またはアルファベット順でクライアントを並べ替えます。また、リスクのある（アンバー／レッド）アカウントのみへの絞り込みも任意で指定できます
• チームフィルター（任意）：代理店内の複数のチームポッドが異なるクライアントを担当している場合、アカウントリードまたはチームポッドで絞り込みます
• 比較基準（任意）：現在の期間を前の期間、前年の同じ期間、または計画／目標と比較します。デフォルトは前の期間です
• アラートしきい値の上書き（任意）：パフォーマンス低下アラートまたは予算消化許容範囲のカスタムしきい値。デフォルトはパフォーマンス低下が20％、消化率の差異が10％です
• エクスポート形式（任意）：Markdown、Google Sheets、または Slack メッセージとして出力するかを指定します。デフォルトは Markdown です

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み取り、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドのトーン、対象市場向けのコンプライアンスルール（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。また、~/.claude-marketing/brands/{slug}/guidelines/_manifest.json にガイドラインがあるか確認し、存在する場合は制約を読み込みます。~/.claude-marketing/sops/ に代理店の SOP があるかも確認します。ブランドが存在しない場合は、「まずブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. すべてのブランドを列挙する：~/.claude-marketing/brands/ をスキャンし、設定済みのすべてのブランドディレクトリ（_active-brand.json を除く）を確認します。各ブランドの profile.json を読み込み、クライアント名、業界、契約形態、契約期間、担当チームメンバー、KPI 目標を取得します。
3. ブランドごとのキャンペーンデータを取得する：対象となる各ブランドについて、python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns を実行し、進行中のキャンペーン、ステータス、予算、目標を取得します（単一のキャンペーンの詳細を取得するには、--action get-campaign --id {id} を使用します）。
4. ブランドごとの実行状況を取得する：各ブランドについて、python "${CLAUDE_PLUGIN_ROOT}/scripts/execution-tracker.py" --brand {slug} --action get-history を実行し、記録された実行内容（完了した成果物、ローンチ、タスク）を取得してから、分析で保留中／期限超過の状況を判断します。
5. ブランドごとの予算消化状況を確認する：各ブランドについて、当該期間の実績支出額と計画支出額を比較し、予算消化率を計算して、現在の支出ペースで期間終了時の支出額を予測します。
6. クライアントごとの健全性スコアを算出する：skills/context-engine/agency-operations-guide.md の RAG スコアリング式を適用します。
   • Green：すべての KPI が順調で、予算消化ペースに問題がなく（乖離 10％以内）、期限超過の項目がなく、コンテンツのパイプラインが滞りなく進行している
   • Amber：1～2 個の KPI にリスクがあり、予算消化ペースに軽微なずれがあり（10～20％）、期限が近い項目がある、または承認待ちが長期化している
   • Red：KPI の大幅な未達、予算超過（20％超）、期限超過、キャンペーンの停滞、または MCP の接続切断がある
7. ポートフォリオ全体の KPI を集計する：進行中のキャンペーン総数、月間支出総額、クライアント全体の平均 ROAS、リード／コンバージョンの合計、保留中の成果物総数、ポートフォリオ全体の健全性の内訳（Green／Amber／Red の件数と割合）を集計します。
8. チームの稼働率を確認する：python "${CLAUDE_PLUGIN_ROOT}/scripts/team-manager.py" --action check-capacity --brand {slug} を実行し、現在のチームの業務量を評価します。チームメンバーごとの対応可能な余力、過負荷のスタッフ、サービス提供が不足するリスクのあるアカウント、請求対象時間の記録を確認します。Claude Code のコスト項目を追加するのは任意です。ユーザーがデータを提供した場合に限ります。 プラグインは Claude Code の使用状況を直接読み取れません。ユーザーが自身の /usage コマンド（対話形式で実行する Claude Code CLI のスラッシュコマンド）の出力を貼り付けた場合は、報告されているモデルごとのトークン数／コストを集計し、「Claude Code の消費量」項目にまとめます。これにより、経営陣は月次請求の前に AI コストを把握できます。モデル名はユーザーの /usage 出力にある表記をそのまま使用し、特定のモデル ID を推測しないでください。ブランドごとのディレクトリを使うワークスペース（~/work/clients/{slug}）であれば、数値をブランド別に割り当てられます。
9. 保留中の承認を特定する：すべてのブランドの実行ログを確認し、クライアントまたは社内の承認待ち項目を洗い出します。48 時間を超えるものは期限超過として表示し、ブランドと緊急度（通常、時間的制約あり、ブロッキング）ごとに分類します。
10. 今後の期限を提示する：すべてのブランドについて、今後 7 日間と 14 日間の期限をまとめます。対象はキャンペーンのローンチ、コンテンツの納期、レポートの提出期限、契約上の節目、契約更新日、QBR の予定です。
11. アラートと異常を検出する：主要 KPI が前週比で 20％を超えて急落したブランド、予算消化に問題があるブランド（計画より 10％を超えて先行または遅延）、5 日以上活動のない停滞中のキャンペーン、MCP の接続障害、期限切れが近い認証情報を検出します。
12. コンテンツのパイプラインを確認する：すべてのブランドのコンテンツ状況を集計し、下書き、レビュー中、承認済み、スケジュール済み、公開済みの項目を確認します。特定の段階でコンテンツが滞っているボトルネックを特定します。
13. 傾向を比較する：現在のポートフォリオの健全性を、選択した基準期間と比較します。各クライアントとポートフォリオ全体について、改善、安定、悪化の傾向を方向矢印とともに表示します。
14. ポートフォリオダッシュボードを作成する：すべてのデータを、ユーザーの希望に沿って並べ替えた構造化ダッシュボードにまとめます。個々のクライアントについて詳細を掘り下げられるようにします。

出力

以下を含む、構造化されたポートフォリオダッシュボードです。

• ポートフォリオの健全性サマリー：対象となるクライアントの総数、健全性の分布（緑／黄／赤の件数と割合）、ポートフォリオ全体の健全性スコア（クライアントの支出額で加重）、期間ごとの傾向の方向性
• クライアント別の健全性カード：ブランドごとに、クライアント名、健全性スコア（RAG）、実施中キャンペーン数、月間支出額と予算進捗状況、主要 KPI と目標値および差分、次の期限、該当する場合は最優先アラート、担当アカウントリード
• KPI 集計表：ポートフォリオ全体の総支出額、平均 ROAS、実施中キャンペーン総数、獲得したリード／コンバージョンの総数、コスト効率の傾向、方向を示す矢印付きの期間比較
• 予算進捗サマリー：ブランドごとの予算進捗状況（計画どおり、支出不足、超過支出）、期間終了時の支出予測、計画との差額および割合、ポートフォリオ全体の予算進捗集計
• チーム稼働状況マトリクス：チームメンバーごとの作業負荷（担当アカウント数、割り当て時間、稼働率、請求可能時間の比率）、過負荷のアラート、新規業務に対応可能な余力、人員配置の推奨事項
• ブランド別の Claude Code 利用状況 — ユーザーから /usage データが提供された場合のみ：ブランドに紐付けられた作業ディレクトリごとの集計。ユーザーの /usage 出力に記載されたモデルティアを使用し、レポート対象期間のトークン合計と USD コストを表示します。同じリテイナーティアのポートフォリオ中央値の 2 倍を超える Claude Code 支出があるブランドには、エンゲージメントパターンの見直し、または料金の再交渉の候補としてフラグを付けます。利用状況データが提供されていない場合は、このパネル全体を省略します。
• 承認待ちキュー：ブランド全体で承認待ちのすべての項目について、項目の説明、経過時間（時間単位）、担当者、ブランド、緊急度、遅延による推定影響を表示します
• 今後の期限（7 日／14 日）：今後の期限を時系列で一覧表示し、ブランド、納品物の種類、担当者、残り日数、依存関係の状況、期限を逃した場合のリスク評価を示します
• コンテンツパイプラインの状況：すべてのブランドについて、下書き、レビュー、承認済み、スケジュール済みの各段階にあるコンテンツを集計し、段階ごとの件数とボトルネックを特定します
• アラートと異常のパネル：パフォーマンスの低下、予算進捗の問題、停滞中のキャンペーン、MCP 接続の失敗、期限切れ間近の認証情報、または早急な対応が必要な期限超過項目を、重大度の高い順に表示します
• 契約と更新のトラッカー：契約更新の予定、エンゲージメントの節目、更新時期が近いクライアントの継続リスク指標を表示します
• 詳細調査の手引き：/digital-marketing-pro:performance-report、/digital-marketing-pro:client-report、または /digital-marketing-pro:credential-switch を使用してブランドのコンテキストを有効にし、個別のクライアントを詳しく調査する方法を説明します

使用するエージェント

• agency-operations — ポートフォリオの集計、クライアントごとの健全性スコアの算出、チーム稼働状況の分析、承認状況の追跡、期限の取りまとめ、予算進捗の計算、コンテンツパイプラインの集計、アラートの検出
• analytics-analyst — 指標の分析、KPI の集計、傾向の計算、異常の検出、ポートフォリオ全体のパフォーマンスのベンチマーク、比較基準値の計算