paw-cra-design-batch

バッチデザイン制作

概要

キャンペーン向けのビジュアルを一括制作します。コンテンツカレンダーまたはキャンペーン概要から、各プラットフォームですぐに使えるビジュアルアセット一式を作成します。このワークフローでは、概要の解析、制作キューの作成、ブランド検証を伴う各アセットの生成、機械可読なマニフェストを含む整理済みバンドルの納品まで、複数アセットの制作を処理します。

引数： --headless / -H を指定すると、対話なしで完全自律型のバッチ制作を実行できます。

出力： 整理されたキャンペーンアセットのバンドルフォルダーと、制作したすべてのアセットの仕様を記載した batch-manifest.json

起動時

{project-root}/.pawbytes/config/config.yaml と {project-root}/.pawbytes/config/config.user.yaml（ルートレベルおよび cra セクション）から利用可能な設定を読み込み、解決した値をセッション全体に適用します（デフォルト値は括弧内）。

• {user_name}（null）— ユーザーを名前で呼びます
• {communication_language}（English）— すべてのやり取りで使用します
• {document_output_language}（English）— 生成するドキュメントの内容に使用します
• {fal_key}（null）— 画像生成用の fal.ai API キー
• {output_directory}（.pawbytes/creative-suites）— 出力先のベースパス

共有エージェンシーメモリを {project-root}/.pawbytes/creative-suites/index.md から読み込みます。アクティブなブランドのガイドラインを .pawbytes/creative-suites/brands/{active-brand}/guidelines.md から読み込みます。

ナレッジベース： 過去に調査したプラットフォーム仕様とデザインガイドについて、{project-root}/.pawbytes/creative-suites/knowledge/index.md を確認します。

ツールの確認：

• fal_key が利用可能か（必須 — これがない場合、バッチ制作は行いません）
• ffmpeg が利用可能か（任意 — アニメーション付きカルーセルにのみ必要）
• Puppeteer/Playwright が利用可能か（任意 — テンプレートのレンダリングに使用）

--headless または -H が指定されている場合は、対話なしでパイプライン全体を実行します。ヘッドレス実行プロトコルについては ./references/autonomous-batch.md を読み込みます。

それ以外の場合は、制作を開始する前に概要／カレンダーの内容をユーザーに確認します。

---

パイプライン

バッチ制作パイプラインは、順次実行されるフェーズで構成されています。次のフェーズを開始する前に、各フェーズを完全に完了します。ヘッドレスモードでは、すべてのフェーズを中断なしで実行します。対話モードでは、生成後のレビューチェックポイントで、最終バンドル作成の前にユーザーが承認、修正、または却下できます。

ステップ 1 — 概要の取り込み

./references/brief-intake.md を読み込みます

受け取ったコンテンツカレンダーまたはキャンペーン概要を解析します。次の情報を抽出します。

• 必要なアセットの合計数
• アセットごとの仕様：プラットフォーム、フォーマット、寸法、コンテンツ／コピー、ビジュアルの方向性
• ブランドの参照情報（読み込むブランドガイドライン）
• キャンペーン名と命名規則
• 優先順位または並び順の希望

入力がコンテンツカレンダーの場合、各行を制作キュー内のアセットとして扱います。納品物の説明を含むキャンペーン概要の場合は、個々のアセット仕様に分解します。

出力： キュー作成に使える、構造化されたアセットリスト。

ステップ 2 — ブランドとキャンペーンのコンテキスト読み込み

指定されたブランドのガイドラインを読み込みます。既存のアセットを把握し、ビジュアルの一貫性を保つため、.pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/assets/ にある既存のキャンペーンアセットを読み込みます。

キャンペーンに .pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/scripts/ 内の承認済みコピー／スクリプトがある場合は、アセット生成に使用するため、それらを読み込みます。

出力： ブランドのコンテキストと既存キャンペーンのコンテキストを作業メモリに読み込みます。

ステップ 3 — 本番キューの作成

./references/queue-builder.md を読み込みます。

解析済みアセットリストから、順序付きの本番キューを作成します。効率的にバッチ生成できるよう、アセットをプラットフォームと形式ごとにグループ化します（同じプラットフォームのアセットでは、スタイルシードとテンプレートを共有できます）。

各キュー項目について、以下を解決します。

• プラットフォーム仕様（寸法、安全領域、形式）
• テンプレートの選択（コードベースのテンプレートを使用する場合）
• AI 生成パラメーター（モデル、スタイル、シード戦略）
• テキストオーバーレイの要件
• エクスポート形式と命名規則

連番の命名規則を適用します。{campaign}_{platform}_{type}_{NNN}.{ext}（例：summer-sale_instagram_post_001.png）。

出力： アセットごとの仕様をすべて確定した、順序付きの本番キュー。

ステップ 4 — バッチ生成ループ

./references/batch-generation.md を読み込みます。

本番キュー内の各アセットについて、以下を実行します。

1. プラットフォーム仕様を読み込む — 寸法、安全領域、形式の要件を確認します。
2. AI 画像を生成する — 確定済みのプロンプトとパラメーターを使用して fal.ai で生成します。モデルの選択には、Designer の AI モデル選択ガイドを使用します。生成した画像はすべてローカルパスにダウンロードします。
3. テンプレート／テキストオーバーレイを適用する — アセットがコードベースのテンプレートを使用する場合は、生成した背景に HTML/CSS オーバーレイをレンダリングします。AI 生成のみの場合は、画像編集でテキストオーバーレイを適用します。
4. ブランドを検証する — 出力をブランドガイドラインに照らして確認します。色、タイポグラフィ、ロゴの配置、ビジュアルスタイルの一貫性が正しいかを確認し、逸脱があれば記録します。
5. 連番の命名規則でエクスポートする — ステップ 3 の命名規則に従って、キャンペーンアセットフォルダーに保存します。

進捗を追跡します。完了した各アセットを進捗記録に記録します。アセットの生成に失敗した場合は、理由とともに失敗を記録して次のアセットに進み、バッチ全体を停止しないでください。

出力： キャンペーンフォルダー内の生成済みアセットと、アセットごとの生成ログ。

ステップ 5 — バンドルの整理

生成したすべてのアセットを、整理されたキャンペーンフォルダー構成にまとめます。

{output_directory}/brands/{brand}/campaigns/{campaign}/assets/batch-{date}/
  instagram/
    posts/
    carousels/
    stories/
  linkedin/
    posts/
    carousels/
  tiktok/
  x-twitter/
  facebook/
  youtube/
  print/
  batch-manifest.json

アセットを生成場所からこの整理済みの構成に移動またはコピーします。プラットフォームフォルダー内の各アセットに、一意の連番ファイル名が付いていることを確認します。

ステップ 6 — バッチマニフェスト

バンドルのルートに batch-manifest.json を生成します。このマニフェストは、生成したすべての内容を記録する機械可読形式のファイルです。

完全なスキーマについては、./references/manifest-schema.md を読み込みます。

マニフェストには以下を含めます。

• キャンペーンのメタデータ（名前、ブランド、日付、アセット総数）
• アセットごとのエントリー：ファイル名、プラットフォーム、寸法、形式、ファイルサイズ、生成モデル、生成ステータス（成功／失敗／スキップ）、ブランド検証ステータス
• 概要統計：生成数、失敗数、スキップ数、対象プラットフォーム

ステップ 7 — レビューゲート

インタラクティブモード： 生成したすべてのアセットをプラットフォームごとにまとめて提示します。サムネイルまたはファイルパスを表示します。成功数、失敗数、ブランド検証に関する警告があればその件数も含めます。バッチを承認するか、特定のアセットの修正を依頼するか、却下するかをユーザーに尋ねます。

ヘッドレスモード： このゲートを完全にスキップします。概要を日次アクティビティファイルに記録し、ステータス更新に進みます。

ステップ 8 — ステータスの更新

完了ステータスをキャンペーンメモリと日次ログに記録します。

キャンペーンステータス： .pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/status.md を更新し、バッチ制作の結果（何を制作したか、保存場所、失敗内容）を記録します。

日次ログ： .pawbytes/creative-suites/daily/{YYYY-MM-DD}.md に追記します。

## {HH:MM} [Designer/Batch]
**Task:** Batch production — {campaign}
**Brand:** {brand}
**Produced:** {N} assets across {M} platforms
**Failed:** {F} assets
**Location:** {bundle path}
**Manifest:** {manifest path}

---

エラー処理

• fal_key がない場合： 生成機能がなければアセットを作成できないため、明確なメッセージを表示してバッチを中止します。
• 個別のアセット生成に失敗した場合： 失敗を記録します。一時的なエラー（HTTP 429、500、502、503、504、タイムアウト）の場合は、5 秒待ってから 1 回再試行します。再試行にも失敗した場合は次のアセットに進み、マニフェストに status: "failed" として、エラーの理由および retried: true を記載します。
• ブランドガイドラインがない場合： 警告を表示し、可能な範囲で生成を続行します。マニフェストでは、すべてのアセットに brand_validated: false を設定します。
• テンプレートのレンダリングに失敗した場合： 該当アセットの生成を純粋な AI 生成に切り替え、マニフェストに切り替えたことを記載します。

プラットフォーム仕様のクイックリファレンス

キューの作成時に使用する簡易版の寸法一覧表については、./references/platform-specs-quick.md を参照してください。詳細な仕様については、Designer の platform-specifications.md を参照してください。

AI モデルの選択

Designer エージェントのモデル選択ガイドを使用してください。バッチ生成では、以下を優先してください。

• Nano Banana Pro — タイポグラフィを含むマーケティング投稿に最適です。
• FLUX.2 [flex] — 大量生成において、品質と速度のバランスが取れています。
• FLUX.1 [schnell] — 迅速なプロトタイピングや、プレミアム品質より速度が重視される非常に大規模なバッチに使用します。