agency-multi-brand-pack

エージェンシー向けマルチブランドパック

N社のリテイナークライアント向けの生成を、連携した1回の処理で実行します。各クライアントの出力は厳密に名前空間で分離され、各ジョブはそのクライアントのブランドルールによって制御され、すべての実行が法務と請求の監査に対応します。

クライアントN社 × クライアントあたりテンプレートM個 → バッチ1回、混在ゼロ。 クライアントのポートフォリオ全体で毎週／毎月のクリエイティブ制作サイクルを実施するエージェンシー向けです。

使用するタイミング

• 複数のリテイナークライアントに向けた毎週／毎月のリテイナー更新
• ポートフォリオ全体の季節に合わせたリスキン（例：リテイナーブランド8社すべてのホリデー向け更新を1回のバッチで実施）
• 各ピッチに独自のブランドモックアップセットが必要な、複数クライアント向けピッチ週
• 財務／法務部門がクライアントごとの費用内訳を必要とする、監査対応の制作実行
• 「各クライアントのルールに沿って、同じパイプラインをすべてのクライアントに実行する」ことがタスクとなる、あらゆるエージェンシーのワークフロー

次の用途には使用しないでください： 1社のクライアント向けの詳細な制作作業。agency-pitch-mockups またはクライアント固有のワークフローを使用してください。マルチブランドは、ポートフォリオを並行処理するためのものです。

前提条件

ユーザーに1つのメッセージで以下を尋ねます。

1. クライアントリスト — 対象クライアントのスラッグ（例：acme-fintech、zest-retail、nova-travel）。各クライアントにロック済みのbrand-system.jsonが必要です。
2. クライアントごとのテンプレートセット — 全クライアントで共通ですか（ヒーロー＋ソーシャル3点＋OG）、それともクライアントごとに納品物が異なりますか？
3. 今週のテーマ／ブリーフ — クライアントごとに再表現するブリーフ1つですか（例：「Q2製品更新」）、それともクライアントごとに完全に独立したブリーフですか？
4. 出力先 — クライアントごとのDriveフォルダーですか？Dropbox／S3ですか？社内リポジトリのパスですか？
5. 請求範囲 — 各ジョブにclient:<slug>のタグを付けると、gen-ai historyからクライアントごとの費用を取得できます。
6. 同時実行数の上限 — デフォルトは4です。すべてのクライアントでプレミアムのレート制限が適用される場合は、8に引き上げてください。

リスト内のクライアントにbrand-system.jsonまたはbrand.mdがない場合は、そこで停止し、まずそのクライアントに対してagency-brand-scopingを実行してください。ブランドファイルをロックせずにバッチ生成しないでください。

実行方法

1. VERIFY BRANDS  → every client in scope has clients/<slug>/brand.md + brand-system.json
2. SCAFFOLD       → build per-client manifest fragments, merge into one master manifest
3. ESTIMATE       → gen-ai batch run <manifest.json> --dry-run + estimate; break into smaller batches if > $20
4. RUN            → `gen-ai batch run <manifest.json>` with client names in job IDs and a resume-ready output dir
5. VERIFY         → per-client output folders populated; cross-check any NULLs in results.json
6. AUDIT          → export per-client spend + asset list for billing
7. DELIVER        → folder per client, approved files uploaded or linked in the retainer channel

ルール：

• クライアントごとにフォルダーを1つ使用します。 out/<slug>/...とし、ファイル名が衝突する可能性のある共通出力フォルダーは使用しないでください。
• バッチ単位ではなく、ジョブごとにブランドコンテキストを指定します。 各ジョブのプロンプトには、該当するクライアントのbrand.mdの制約を含めてください。バッチレベルの汎用プロンプトが、混在の最大の原因です。
• 安定したジョブIDを使用します。 ダウンロードしたファイルとresults.jsonを簡単に分類できるよう、各idにクライアント名またはキャンペーン名を含めてください。
• デフォルトではgen-ai batch resume <output-dir>で再開します。 gen-ai batch resume <output-dir>を実行すれば、途中の失敗によって完了済みの半分まで無駄になりません。

クイックリファレンス

{
  "batch_kind": "multi-brand-pack",
  "week": "2026-04-22",
  "defaults": { "model": "recraftv4", "aspectRatio": "1:1" },
  "clients": [
    { "slug": "acme-fintech", "templates": ["hero", "social-1", "og"] },
    { "slug": "zest-retail",  "templates": ["hero", "social-1", "og"] }
  ]
}

スキャフォールディングスクリプトが、これをCLIが必要とするフラットなjobs[]マニフェストに展開します。再現性を確保するため、展開後のマニフェストをout/retainer-<date>/manifest.jsonにチェックインしておきます。

クイックリファレンス

サブタスク	モデル	備考
クライアントごとのヒーロー（デフォルト）	recraftv4	デザイン重視で、ブランドのパレットを尊重します
クライアントごとのヒーロー（写真主導のブランド）	flux-2-pro	写真を多用するクライアントではジョブレベルで上書きします
ソーシャルタイル（1:1、9:16）	recraftv4	同じブランドルールで、より低コストです
OG／読みやすい見出しスライド	ideogram-v3	テキストを確実にレンダリングできる唯一のモデルです
商品写真の背景置換	recraftv3-replace-bg	ECリテイナー向けです
ブランドごとの動画カット	kling-v3-standard（ドラフト）／kling-v3-pro（最終版）	クライアントごとの同時実行数は2です

手順

• クライアントごとにブランドファイルを1つ用意し、「代理店共通」のルールは設けません。 各クライアントが、自社ブランドの厳密な管理に対価を支払います。
• すべての出力をスラッグで名前空間化します — out/<slug>/、drive:retainer-<date>/<slug>/、results.json のジョブ ID などです。冗長なくらいが適切です。
• マニフェストはスクリプトで生成します。 クライアントが3社を超える場合、clients[] × templates[] を反復処理する Node/Python のスキャフォールドを使えば、コピー＆ペーストによるミスを防げます。
• 実行前に必ず見積もります。 複数ブランドのバッチでは20ドルのしきい値を簡単に超えるため、一時停止して確認してください。
• results.json をリポジトリに保存します。 法務上の監査証跡、請求の入力情報、再現性の確保に役立ちます。
• クライアントごとのプロンプトライブラリを clients/<slug>/prompts/ に用意します — マニフェストからこれらを参照すれば、編集内容が反映されます。
• ブランドに関わる出力を確認します。 `` — ブランドに合わないアセットを使うより、アセットがないほうが適切です。
• 毎週の定期実行には cron と完了時の Slack webhook を設定します。gen-ai-batch.md §CI recipes を参照してください。

落とし穴

• ブランドの混同 — 1つのジョブでも rules がないと、バッチ全体が疑わしい状態になります。対策：バッチレベルではなく、ジョブごとに rules を設定します。
• スラッグのプレフィックスがないことによるファイル名の衝突 — クライアントBの hero.webp がクライアントAのファイルを上書きします。
• 100ジョブのバッチで gen-ai batch resume <output-dir> を使わずに実行すること — プロバイダーの一時的な不具合1回で、実行全体が無駄になります。
• 共有 Drive フォルダー — クライアントAがクライアントBのフォルダーを見られる状態になり、NDA 違反につながります。
• タグのないジョブ — クライアントごとの請求額を出せません。経理に聞かれても回答できません。
• 最高性能のモデルをすべてに適用すること — 週次バッチが15ドルではなく40ドルになります。まず下書きを作成し、必要なものだけアップグレードします。

検証

gen-ai whoami を実行して認証を確認し、失敗したコマンドを --debug を付けて再実行します。

ステップ1：ブランドを確認してマニフェストを作成する

CLIENTS=("acme-fintech" "zest-retail" "nova-travel")
WEEK=$(date +%Y-%m-%d)

# Sanity check: every client has a brand file
for c in "${CLIENTS[@]}"; do
  test -f "clients/$c/brand.md" || { echo "Missing brand.md for $c"; exit 1; }
done

ステップ2：クライアントごとのマニフェスト断片を結合する

cat > /tmp/multi-brand-$WEEK.json <<'EOF'
{
  "defaults": { "model": "recraftv4", "aspectRatio": "1:1" },
  "jobs": [
    { "id": "acme-fintech/hero",    "prompt": "acme-fintech Q2 hero — editorial, restrained", "aspectRatio": "16:9" },
    { "id": "acme-fintech/og",      "prompt": "acme-fintech OG — headline: Q2 launch", "aspectRatio": "1200x630", "model": "ideogram-v3" },
    { "id": "zest-retail/hero",     "prompt": "zest-retail Q2 hero — playful, bold color", "aspectRatio": "16:9" },
    { "id": "nova-travel/hero",     "prompt": "nova-travel Q2 hero — cinematic wide", "aspectRatio": "16:9", "model": "flux-2-pro" }
  ]
}
EOF

gen-ai batch run /tmp/multi-brand-$WEEK.json --dry-run
gen-ai batch run /tmp/multi-brand-$WEEK.json -c 4 -o "out/retainer-$WEEK"

各ジョブの id にある / によって、クライアントごとのサブフォルダーが自動的に作成されます — 出力は out/retainer-<date>/<client-slug>/<asset>.webp と results.json に保存されます。

ステップ3：クライアントごとに監査して納品する

# Per-client completion breakdown from results.json
node -e '
  const r = require("./out/retainer-2026-04-22/results.json");
  const by = {};
  for (const j of r.jobs) {
    const c = j.id.split("/")[0];
    by[c] ||= { completed: 0, failed: 0 };
    by[c][j.status] = (by[c][j.status] || 0) + 1;
  }
  console.table(by);
'

クライアントごとにアーカイブ用サブフォルダー retainer-$WEEK/<client-slug>/ を作成し、アセット一覧と gen-ai pricing から取得した推定費用を記載した概要を保存します。共有するのはクライアントごとのフォルダーリンクだけにし、マスターフォルダーは決して共有しないでください。

コストと所要時間

フェーズ	一般的な費用	一般的な所要時間
スコーピング（新規クライアントごと、初回のみ）	約1ドル	30分
制作（週次リテイナー、8クライアント × 4アセット）	15～30ドル	バッチ処理とレビューで20～40分
最高性能モデルへのアップグレード作業（ヒーローアセットを2～3点）	5～10ドル	10～15分

クライアントごとの週次費用は results.json から追跡できるはずです。追跡できない場合は、タグ付けに問題があります。

関連項目

• workflows/agency-brand-scoping/ — クライアントごとに必要な事前作業
• workflows/agency-pitch-mockups/ — クライアントごとの提案用バリエーション
• workflows/agency-client-handoff/ — 契約終了時にリテイナーの履歴をまとめる
• gen-ai-batch.md — 同時実行、gen-ai batch resume <output-dir>、監査のレシピ