build-a-brand

ブランドを構築する

以下のツールはPika MCPのツールで、名前にプレフィックスを付けていません。セッションで公開されているPika MCPのプレフィックスを付けて、それぞれを呼び出してください。

アイデア、ウェブサイト、参考ブランドのリスト、製品写真、リフレッシュしたい既存ブランドなど、あらゆる入力から、すぐに使えるブランドアイデンティティを作成します。

これは、戦略、アイデンティティ、デザイン、コピーに焦点を当てた、単独で完結するブランド構築ワークフローです。デフォルトの出力は、数分で完成できるクイックブランド成果物です。14〜16ページのブランドガイドラインPDFも引き続き利用できますが、ユーザーが明示的に詳細版を求めるか、クイック版の後にさらに深掘りすることを選んだ場合に限ります。

参考ファイル

該当するフェーズが始まったときにのみ、以下を読み込みます。

• references/brand-directions.md — 戦略の切り口の構成と、差別化されたポジショニングボード。
• references/brand-identity.md — ロゴ制作の流れ、シンボルのルール、コンセプトの方向性、ボード用コピーの分量。
• references/brand-guidelines.md — ガイドライン全体のレイアウト、レンダリング仕様、ページ構成、品質保証ルール。
• references/brand-md-template.md — 機械可読なbrand.mdに必要な構成。

実行モデル — ローカル優先、必要な場合のみクラウドを使用

このスキルはローカル優先です。決定論的な制作作業はユーザーのマシン上で行います。

• ローカル： ワークスペースのセットアップ、ダウンロードしたフォント、ダウンロード後に生成された画像ファイル、画像圧縮、背景の透過処理、16x16ファビコンのテスト、HTML/CSSページの構築、PDFのレンダリング、PNG/JPGの品質確認用スクリーンショット、ロゴアセットの組み立て、トークン／プロンプトファイル、最終的なzipのパッケージ化。
• クラウド： 有料生成（シンボル、ムード画像、写真、イラスト、アンビエントテクスチャにはgpt-image-2のみ）と、ブリーフで必要な場合のURL／ソース調査。

クラウドPDFレンダラーは使用せず、デフォルトではPDFをアップロードしないでください。クイックPDF、ボードPDF、ガイドラインPDF、ブランドキットのzipは、Macでは~/Desktopに、Desktopが利用できない場合はプロジェクトの作業ディレクトリに保存してください。ユーザーがホストされたファイルを明示的に求めた場合にのみ、CDN経由でアップロード／共有してください。

PDFアセットの衛生管理： フルサイズのgpt-image-2 PNGを、ボードやガイドラインのPDFに直接埋め込まないでください。これにより以前、PDFのサイズが非常に大きくなり、レンダラーが数MBのCDN画像を取得しようとしてASSET_FETCH_TIMEOUTが発生しました。生成した画像はすべてダウンロードし、使用枠のサイズに合わせて縮小／ダウンサンプリングしてから、レンダリング用HTMLに使用する前に、目標サイズ約85〜180KBのローカルJPEGとして保存してください。透明PNGはロゴ／シンボルのソースアセットと、ファビコン／ロゴの書き出しにのみ使用し、ページ上の写真には使用しないでください。レンダリング用HTMLで、写真やbackground-imageにCSSのfilter:／backdrop-filter:（ウォームグレード、セピア、彩度、明るさ、ぼかし）を決して適用しないでください。 Chromiumがその要素をPDF内でフル解像度のロスレスビットマップにラスタライズするため、上記のJPEG化が無効になり、ファイルサイズが再び膨れ上がります。ウォームグレードを適用したムードボードのページだけで、デッキが70 MBになったことがあります。色調補正はすべて、JPEG自体に適用してください（gpt-image-2のプロンプト内、またはimg.save(..., 'JPEG', ...)を実行するとき）。安全なフィルターは、透明ロゴPNGへのdrop-shadow()のみです。

コストの透明性に関するゲート

有料MCP呼び出しの前に、identity_balance({verbose: true})を一度呼び出してください。現在の残高、直近の消費ペース、残りの利用可能期間を提示してから、次の正確なメッセージで選択した詳細度を確認してください。

推定コスト：約100〜300クレジット（約$1〜$3）でクイックブランド、または約900〜1,500クレジット（約$9〜$15）でフルブランドブックです。これらの範囲には、gpt-image-2によるシンボル／ムード／タッチポイントの生成と、画像の品質確認に失敗した場合の対象を絞った再生成1回分が含まれます。クイックブランドは通常$5未満ですが、フルブランドブックは$5を超えます。続行するにはproceed、停止するにはcancelと返信してください。

ユーザーがproceedと返信するまで、有料MCPツールを呼び出さないでください。ユーザーがcancelと返信した場合は、生成せずに停止してください。非対話型の--quick、--full、または--configの呼び出しでは、設定または呼び出しメタデータにcost_ack=proceedが必要です。これがない場合は、クレジットを消費せず、推定コストを提示して停止してください。

デプスモード

長時間かかる生成やレンダリング作業を始める前に、デプスを選択します。

1. クイックブランド（デフォルト） — 初回の創業者キット作成、--quick、クリエイター向けチュートリアルのフロー、バッチ／サブエージェント呼び出し、またはユーザーがフルブランドブックを明示的に求めずにブランドを依頼した場合に使用します。目標：利用可能な入力を受け取ってから8～12分以内（ユーザーの返信待ち時間を除く）。QAに失敗した場合を除き、生成画像は最大4枚まで。クイックPDFレンダリングを1回行い、必要に応じてQA用に再レンダリングを1回行います。
2. フルブランドブック（オプトイン） — ユーザーが「full」「brand book」「brand guidelines」「14-16-page」「15-page」「--full」と依頼した場合、またはクイックパスの「go deeper」アップグレードを承認した場合に限り使用します。目標：選択内容の確定後25～45分（ユーザーの返信待ち時間を除く）。

クイックブランドは、フルガイドラインデッキの不完全版や失敗版ではありません。独自の完了基準を持つ、意図的に規模を抑えた成果物です。選択したモードがフルの場合は、フルガイドラインのすべての完了条件が引き続き適用されます。

モードの選択

ステージ 0 — インテーク（引数なしのメニュー）

入力がない状態（アイデア、URL、写真、参考ブランド、会話内の関連する過去の文脈がない状態）で呼び出された場合、このメニューをそのまま全回答として出力し、終了します。ツールは呼び出さないでください。ユーザーの次のメッセージを待ちます。

何のブランドを作成しますか？ 次のいずれかを貼り付けてください。

• アイデア／説明 — 例：「猫好き向けのストリートウェアブランド」
• ウェブサイトのURL — 例：「example.com にある既存サイトをリブランドしたい」
• 製品写真 — チャットにアップロードしてください
• 参考ブランド — 例：「Aesop + Patagonia のような雰囲気にしたい」
• 刷新したい既存ブランド — 名前と、うまくいっている点／いない点

デフォルトではクイックブランドから始めます。より詳細な14～16ページのガイドライン作成を希望する場合は、full brand book とお伝えください。

ユーザーがすでに上記のいずれかを提示している場合は、メニューを省略して選択されたモードに進みます。デフォルトのクイックブランドパスではクイックのステップ1へ、フルブランドブックモードが選択されている場合は以下のステップ1へ進みます。

Stage 0.5 — クイックブランドと非対話型の高速レーン

呼び出し元が --quick を指定した場合、明示的にフル版を求めていない場合、または CI、サブエージェント、バッチジョブ、チュートリアルの録画、その他の非対話型ハーネスから実行していると述べた場合は、クイックブランドモードを使用してください。

フルブランドブックモードを使用するのは、呼び出し元が --full を指定した場合、設定で mode: "full" を設定した場合、完全版のガイドライン／ブランドブックを明示的に求めた場合、またはクイック実行後の「さらに詳しく」への切り替えを承認した場合に限ります。

このセクションは、以下にある対話形式での質問／待機の指示より優先されます。 クイックモードが適用される場合は、以下のクイックブランドワークフローを使用し、必須入力が本当に不足している場合を除き、複数ターンにわたるフルワークフローのヒアリングに進まないでください。

• --config <path> は、ヒアリングへの回答を事前に設定した JSON ファイルを指定します： input、photos、reference_brands、audience、positioning、assets_to_keep、 references、mode、chosen_direction、chosen_identity、export_kit。
• --quick はクイックブランドモードを意味します。すべての確認ゲートでモデルの判断を使用してください。 元の入力が完全に欠けている場合に限り質問してください。それ以外の場合は妥当な デフォルトを推測し、最も有力な戦略の方向性とアイデンティティの選択肢を選んで、 そのまま進めてください。
• --full はフルブランドブックモードを意味します。非対話型実行時も確認ゲートではモデルの判断を使用しますが、必須の14〜16ページのガイドラインを省略してはいけません。
• --quick または --config を使用する場合は、成果物のプレビュー、戦略の方向性の選択、アイデンティティの選択肢、ブランドキットの書き出しゲートで確認のために処理を止めないでください。前提をその場で記録してから続行してください。
• 必須のアセットが利用できず、入力から推測することもできない場合は、複数ターンの質疑応答を始めず、不足項目を簡潔にまとめた一覧を一度だけ提示して停止してください。
• クイックモードでは、以下で定義するクイックブランドパッケージを納品してください。凝縮したフルガイドラインデッキとして説明してはいけません。
• フルモードでは、呼び出し元が非対話型であることや実行時間が限られていることを理由に、凝縮版または一部のみのブランド成果物を納品してはいけません。6ページに凝縮したデッキは、必須の14〜16ページのガイドラインの代わりとして認められません。実行時間の予算が尽きた場合は、完了済みのページ／アセットを含む再開可能なチェックポイントを保存して停止し、ワークフローを完了扱いにしてはいけません。

自律型フルモード： 明示的にフル版を求められており（--full、mode: "full"、またはユーザーが完全なブランドブック／ガイドラインを要求）、実行時に cost_ack=proceed が設定済みの場合に限り、これを使用してください。この場合、ブリーフを仕様として扱います。ユーザーがボードを選ぶのを待ったり、キットの書き出し前に明示的な承認を待ったりしないでください。以下のフル版の成果物をすべて、1回の実行で作成してください。

1. brand-boards.pdf — 3種類のボードをすべて作成し、最も有力なボードまたはハイブリッドをモデルの判断で選びます。
2. brand-guidelines.pdf — 選んだ方向性に基づいて、フル版の14〜16ページのガイドラインを作成します。
3. brand-kit.zip — ガイドラインの QA 合格後、完全なキットを書き出します。

前提と選んだ方向性を brand.md と最終回答に記録してください。ブリーフが曖昧すぎてボードの選択が恣意的になる場合は、自律的に実行できるふりをせず、不足している判断事項を一度だけ提示して停止してください。明確なブリーフがある非対話型の実行でも、明示的にフル版を求められていなければクイックモードを使用してください。バッチ／チュートリアル／ファウンダーキットの実行を、ブリーフが明確であるという理由だけでフルモードに切り替えてはいけません。

クイックブランドワークフロー（デフォルト）

クイックブランドモードでは、このワークフローを使用してください。これはファウンダーキット向けの高速レーンです。選択肢と生成するアセットを減らし、初回実行の割り当てを使い切ることなく、後続のスキルに活用できる、完全なスターターブランドを作成します。

クイックステップ 1 — 1回で必要事項を確認

使える情報がある場合は、長い質問を始めないでください。使用する前提を示し、回答によってブランドが大きく変わる場合に限り、簡潔な質問を最大3つまで尋ねます。

• 何を販売または提供していますか？
• 誰を対象としていますか？
• 既存の名前、ロゴ、色、フォント、写真、参考資料のうち、引き継ぐものはありますか？

--quick、--config、CI、サブエージェント、一括処理、チュートリアル録画の各フローでは、元の入力が完全に欠けている場合を除き、これらの回答を待たないでください。妥当なデフォルトを推定し、出力に記録します。

クイックステップ 2 — 最も強い方向性を1つ選ぶ

クイックモードでは、2〜3案の方向性や3種類のアイデンティティ案を提示しないでください。モデルの判断で、最も強力な戦略とアイデンティティを1つ選びます。クイック戦略には、次の項目を含めます。

• ブランド名または引き継ぐ名前
• タグライン（8語以内）
• オーディエンスセグメント：主要セグメント、副次セグメント（複数可）、代表的なペルソナ1人
• ポジショニングステートメント
• 引き継ぐアセット
• 参考ブランド／インスピレーション（提供されている場合）

クイックステップ 3 — スターターアイデンティティを作成する

一貫性のあるアイデンティティシステムを1つ作成します。

• ロゴのコンセプト：ワードマーク＋単独で使えるシンボル／マーク＋ロックアップの方針。新しいシンボルを作る場合は、provider="gpt-image-2" を指定して generate_image を使い、承認済みのシンボルを SVG ではなく、透明 PNG の各サイズで納品します。ワードマークとロックアップのアセットは、実際のフォントテキストをアウトライン化したパスに変換するため、SVG でもかまいません。
• パレット：役割と16進値を指定した基本色4色。
• タイポグラフィ：個性のあるディスプレイフォント1つと実用的な本文フォント1つ。利用可能な場合は Google Fonts の URL を付けます。
• ボイス：トーンの原則3つ、サンプル文3つ、使用禁止の単語／フレーズ5つ。
• 画像の方向性：簡潔な写真／イラストのルールと、テキストなしの画像生成プロンプトに関するガードレール。
• スターター用途例：SNSアバター／アプリアイコン、シンプルなウェブのヒーロービジュアルの方向性、ブランドの種類に合った実用的なタッチポイント1つ。

画像生成は制限してください。生成する画像は、シンボル／マーク画像1点と、ムード画像またはタッチポイント画像最大3点までです。再試行の上限は、生成するブランド画像アセットごとに合計2回（初回生成＋対象を絞った再生成1回）です。QAに失敗した場合は、失敗したアセットのみを再生成してください。いずれかの上限に達したら、クレジットを使い続けずに停止し、代わりにどの失敗アセットまたはレイアウト上の問題を許容するか、ユーザーに尋ねてください。

クイックステップ 4 — クイックブランドパッケージを納品する

クイック版の納品物は、クリエイターがすぐに使い始められるだけの十分な内容にしてください。

[brand-name]-quick-brand/
├── quick-brand.pdf              # 3 pages: cover/strategy, identity system, starter applications
├── brand.md                     # compact machine-readable brand spec
├── README.md                    # how to use the quick brand and when to upgrade
├── logo/                        # symbol, wordmark, and lockup assets that were produced
├── tokens/
│   ├── tokens.css
│   ├── tokens.json
│   └── tailwind.config.snippet.js
└── prompts/
    ├── system-prompt.md
    └── imagery.md

3ページの quick-brand.pdf は、次の構成にします。

1. 表紙＋戦略 — ブランド名、タグライン、ポジショニング、オーディエンスセグメント、代表的なペルソナ、参考資料、ヒーロービジュアル。
2. アイデンティティシステム — ロゴシステム、パレット、タイポグラフィ、ボイスのルール、画像のルール。
3. スターター用途例 — SNSアバター／アプリアイコン、ウェブのヒーロービジュアル／SNSカードの方向性、実際のタッチポイントまたは製品の利用状況を示す画像1点、ブランド固有の「すべきこと」3つと「避けるべきこと」3つ。

quick-brand.pdf は Chrome のヘッドレスモードでローカルにレンダリングしてください（HTML が WeasyPrint 用に書かれている場合は WeasyPrint を使用）。納品前に PNG／JPG のプレビューを確認してください。クイック版のビジュアルQAでは、テキストの見切れ、ロゴ／シンボルの欠落、文字の読みにくさ、生成画像内に焼き込まれたテキスト、空のプレースホルダー、明らかなレイアウトの重なりを確認します。クイックパッケージまたは zip を作成できない場合は、再開可能なチェックポイントを示して停止してください。チェックポイントには、完了したファイル、未作成のファイル、アセットのパス／URL、具体的な阻害要因を記載します。

クイックブランドを納品した後、「さらに詳しく」のアップグレードとして、全14〜16ページのガイドラインを提案します。ユーザーから明示的な依頼がない限り、フルワークフローは開始しないでください。

ブランドブックのフルワークフロー（オプトイン）

このワークフローは、ブランドブックのフルモードでのみ使用してください。

ステップ 1 — 入力を確認する

フルブランドブックモードのみ。

入力はさまざまです。質問をする前に、まず簡潔なアジェンダを提示し、これから何をするのかをユーザーに伝えてください。

here's how this works — 4 steps:
1. **Read the input** — i ask a few questions, you answer, i play back what i'm hearing
2. **3 visual brand boards** — i build a 3-page PDF with three complete brand directions, each with its own colors, fonts, photography, voice samples, and logo concept. you pick one or mix elements.
3. **Build the guidelines** — full 14-16-page brand book PDF for the chosen board
4. **Export the brand kit** — once you're happy with the guidelines, i'll bundle a `brand.md` spec + logo assets (symbol PNG sizes, wordmark SVG/PNG, lockup SVG/PNG) + fonts + tokens + AI prompts as a zip you can use anywhere

let's start. [questions follow]

次に、対象を絞った質問を3〜5個、1つのメッセージで尋ねてください。入力の種類に応じて調整します。

アイデアや説明が送られてきた場合：

• このブランドは何を販売、または提供しますか？（製品／サービス／アプリ／コミュニティ／その他）
• 誰を対象にしていますか？このブランドが対応すべきオーディエンスのセグメントを2〜3つ説明し、主要セグメントの中から具体的で印象的な代表ペルソナを1人挙げてください。
• なぜこれが存在するのでしょうか？既存の選択肢の何が問題なのか、あるいはどんな気持ちを届けようとしているのですか？
• 名前の候補はありますか？それとも、ネーミングもサポートが必要な内容に含まれますか？

ウェブサイトや既存ブランドのURLが送られてきた場合：

• このブランドを刷新しますか？それともゼロから作り直しますか？
• 現在うまくいっていることと、うまくいっていないことは何ですか？
• 現在の顧客と、本来顧客になってほしい人は誰ですか？

製品の写真が送られてきた場合：

• 製品の製造方法、購入または利用した人、価格帯、現在の販売状況や販売チャネル、すでに考えている方向性を尋ねてください。
• 出力はガイドラインとブランドキットの範囲にとどめ、コマースの立ち上げには踏み込まないでください。

参考ブランドのみが送られてきた場合（「Aesop + Patagoniaのような雰囲気のブランドにしたい」など）：

• このブランドは、どのような製品、サービス、または対象に紐づきますか？
• それぞれの参考ブランドのどんな点が特に好きですか？（写真、トーン、控えめな表現など）
• どんな人が購入しますか？このブランドが対応すべきオーディエンスのセグメントを2〜3つ説明し、主要セグメントの中から具体的で印象的な代表ペルソナを1人挙げてください。
• 制約はありますか？（業界、規制、地域、価格帯など）

入力の種類にかかわらず、必ず尋ねること：

• 維持または取り入れたい既存のブランドアセットはありますか？（ロゴ、ワードマーク、シンボル、名前、色、フォント、写真、パッケージなど、失いたくないもの）
• 参考にしたいものやインスピレーション、ムードボードはありますか？
• これはデジタル製品ですか？（アプリ、ウェブサイト、SaaS、ウェブツールなど）これによって、フルガイドラインにアイコンページを含めるかどうかが決まります。非デジタルブランド（製品、サービス、レストラン、ファッションなど）の場合、アイコンページは省略します。

この2つの質問は重要です。ユーザーがすでに持っているものを再生成するのを防ぎ、ユーザー自身が気に入っている参考情報に基づいて作業を進められます。必ず含めてください。

メッセージは1つにまとめてください。質問は全部で5〜7個を目安にし（入力に応じた質問＋共通の2問）、堅苦しくならないよう会話調にしてください。回答があるまで先に進まないでください。

回答を受け取った後、入力と回答を合わせて分析し、次の内容を読み返してください。

• 美的領域：どのようなビジュアルの世界観に属するか
• オーディエンスセグメント：主要セグメント、副次セグメント、そして主要セグメント内の具体的で印象的な代表ペルソナ1人。オーディエンスを過度に具体的な1人に集約しないでください。
• ポジショニング：競合にはない、このブランド独自の強みは何か
• 価格帯／カテゴリーとの適合性：市場のどの位置づけにあたるか
• ストーリーの核：人々が関心を持つ感情的な理由は何か
• 維持するアセット：ユーザーが残したいと述べたもの（既存のワードマーク、名前、色など）を明記してください。
• 作業の基盤となる参考情報：ユーザーが挙げたインスピレーションを列挙してください。

**その後、納品物のプレビューを提示し、具体的な希望を尋ねてください。**ブランドの方向性を決める前に、最終ガイドラインに含まれる内容をユーザーに示し、追加・変更したい項目や、特に取り上げてほしい内容があれば伝えてもらってください。

here's what i'll build into the brand guidelines (14-16 pages depending on your brand):

1. Cover (brand name, tagline, hero mood)
2. Strategy & positioning (primary/secondary audience segments + anchor persona)
3. Brand foundation (mission, values, story)
4. Logo (wordmark + symbol + variants)
5. Logo don'ts
6. Color palette
7. Typography
8. Icons — UI icon system + library guidance, ONLY IF this is a digital product (app / web / SaaS). Skipped for non-digital brands.
9. Voice & tone
10. Imagery rules (photography and/or illustration, adapted to brand medium; splits to 2 pages if hybrid)
11. Visual world / lifestyle imagery
12. Touchpoints (real photos showing the brand in use)
13. Brand applications (mockups: business card, app icon, favicon, etc.)
14. Digital + social
15. Do & don't

plus a brand kit zip at the end with: `brand.md` spec, logo assets (symbol PNG sizes, wordmark SVG/PNG, lockup SVG/PNG), brand fonts, design tokens (CSS / JSON / Tailwind), AI prompts (system prompt + task-specific starters), and the icon SVGs if applicable.

anything you want to add, change, call out specifically, or want me to handle differently? if not, i'll move on to the 3 brand boards.

返答を待ってください。具体的な希望（ページの追加、項目の差し替え、特定セクションへの重点、何かの除外など）があれば、ステップ2に進む前に反映してください。PDFを作成した後で範囲の不一致に気づくより、早い段階で確認するほうがはるかに効率的です。

ステップ 2 — 3つのビジュアルブランドボードを生成する（PDF）

このステップは、ブランドに触れるユーザーにとって最初の視覚的な接点です。これに先立って、テキストだけの「説明」はありません。ボードそのものが、目に見える形の説明です。各ボードには、ひと目で分かる完全なビジュアルアイデンティティを盛り込み、違いを読むだけでなく、見て感じられるようにします。

3ページ構成のPDFを1つ作成します（ボード1つにつき1ページ、各ページ1200×850）。~/Desktop/[brand-slug]-brand-boards.pdf に保存してください。各ボードは、テンプレートの色を変えただけではない、真に異なるブランドの方向性を示すものにします。ビジュアルシステム、レイアウト、フォント、色使い、写真のスタイル、声のトーンに明確な違いを持たせながら、そのブランドが誰のために存在し、なぜ存在するのかを変えてください。

各案には以下を含めてください。

• ワードマーク：ブランドのディスプレイフォントを使用します。ユーザーが気に入っている既存のワードマークがあれば、それを使用します。ロゴが必要な場合や、現在のロゴが気に入っていない場合は、新しいものを提案します。新しいワードマークには、字間の調整、合字、切り込み、字端、大文字・小文字の使い分け、下線など、独自性のあるカスタムの文字処理を加えてください。色を付けたGoogle Fontをそのまま使うだけでは不十分です。
• シンボル／マーク：ワードマークなしでも成立する、単独で使えるグラフィックです。ユーザーが気に入っている既存のシンボルがあれば、それを使用します。それ以外の場合は新しいものを提案します。ユーザーがワードマークを使い続ける場合でも、シンボルがなければ提案してください。ファビコンやアプリアイコンには、文字に頼らないマークが必要です。新しいシンボルは、provider="gpt-image-2" を指定して generate_image で透明PNGを生成してください。背景が透明で、文字、透かし、モックアップのない、中央に配置した正方形のシンプルな単独マークを依頼してください。生成したシンボルをトレースしてSVGにしないでください。承認済みのマスター画像からPNGサイズを出力してください。16×16と512×512の両方で機能する必要があります。
• シール／バッジ：案にシール、スタンプ、バッジ、モノグラムを使う場合、小サイズと中サイズで判読でき、独自性があるものにしてください。汎用的な円形のフォントロックアップ、クリップアート風の紋章、コントラストの低い装飾的な埋め草は不可です。
• タグライン（最大8語）
• 「VOICE」ラベルが見えるボイスサンプル（引用符で囲んだ1文、最大14語）
• コンパクトなボードのストーリー（最大約35語、最低2文）
• 「WORLD」ラベルが見えるライフスタイルの世界観の説明（最大約22語、最低1つの完全な文）
• ライフスタイルのムード画像（gpt-image-2で生成）
• 4色のカラーパレット（HEX値と役割ラベル付き）
• フォント名を記したディスプレイ書体と本文書体の見本

ブランドボードの各ページは、ラベルを読む前にどのアイデンティティか分かるほど、見た目に明確な違いを持たせてください。同じテンプレートの色だけを変えて3案にするのは避けてください。各ボードのレイアウトには、その案のデザイン思想を反映させます。雑誌の表紙風の案は、全面写真とマストヘッド風の見せ方で雑誌の表紙らしく仕上げます。柔らかなコンシューマー向けの案は、丸みのある形や色見本の柔らかな円を使ったホームページのヒーローのように仕上げます。エディトリアルな案は、中央に大きなイタリック体を配置し、写真を inset した文学誌面のように仕上げます。例については references/brand-guidelines.md の「Brand Board Layout — Differentiate per Option」を参照してください。

ラベルを読まなくても、どのブランドか見た目だけで判別できない場合は、以下のビジュアルQAの再試行回数の範囲内で再生成してください。

**ページサイズ：**1200×850px。レンダラーはローカルのChrome headlessを推奨します。WeasyPrintは、WeasyPrint用にHTMLを作成した場合に限り使用できます。ボードPDFとQAプレビューをローカルでレンダリングし、最終版のボードPDFを ~/Desktop にコピーしてください。

**ボードの品質ゲート：**3ページのプレビューは、レンダリングの確認だけでなく、ビジュアルQAにも合格する必要があります。

再試行回数：ブランドボードまたはガイドラインPDFのビジュアルQAループでは、同じ案／デッキに対してレンダリングと修正を合わせて最大2回までです（初回レンダリング＋修正後の再レンダリング1回）。いずれかの上限に達したら作業を中止し、どのアセットまたはレイアウト上の問題を緩和するかユーザーに確認してください。その際、問題のあるページ／アセット名、QAでの理由、現時点で最良のプレビューURLを記載してください。

1. PDF を送信する前に、各 PNG プレビューを確認してください。密度が高すぎて見苦しいもの、階層が弱いもの、単調で濁った配色、読みにくい小さな文字、空のモックアップ／画像枠、切れたテキスト、本文コピーやマストヘッド以外のテキストがアイコン、スウォッチ、シール、写真、スマートフォンのモックアップ、装飾的な罫線と交差しているものは不合格としてください。また、シンボルを 16×16 と 512×512 で確認してください。小サイズで判読できない、濁っている、ありきたりすぎる、またはノイズに埋もれてしまう場合は、納品前に再生成するか、シンプルにしてください。ウェブサイト／ソーシャルメディア／アプリのモックアップはブランドボードでは任意です。実際のコンテンツを含まない限り、追加しないでください。含める場合、ベタ塗りの色付き長方形は、セクションが明示的にカラーパレットの見本である場合を除き、空のプレースホルダーとみなします。
2. 各ボードのプレビューを原寸で確認してください。コントラストが低い文字、読みにくい小さな文字、テキストと写真の衝突、コンテンツの欠落、弱い階層、単調で濁った配色は不合格としてください。写真上へのマストヘッドのワードマーク／タグライン／号数メタデータの重ね合わせは、意図的なネガティブスペースまたはコントラスト用の背景処理を用い、references/brand-guidelines.md のルール 5 で定められたコントラスト QA に合格する場合に限り許可されます。画像上の本文コピーは禁止です。
3. 納品前に、記録された FAIL をすべて修正してください。技術的には有効でも見苦しいボードは不合格とみなし、階層、コピーの密度、または装飾要素を簡素化してから再レンダリングしてください。

フォントのルール： ブランドごとに新しいフォントを選び、かつ個性のあるフォントにしてください。ディスプレイ書体として、Inter / Karla / Outfit / DM Sans / Lato を安易に使わないでください。これらには独自の視点がありません。Google Fonts の全ライブラリを幅広く検討してください。雰囲気に合わせた個性の強いフォントの候補は、references/brand-guidelines.md の「Must Have Character — Don't Default to Safe Fonts」を参照してください。選んだフォントファイルをローカルにダウンロードし、レンダリングする HTML で絶対パスの file:// @font-face 宣言を使用してください。

非ラテン文字のブランド名に対するフォントフォールバック： ブランドボード、クイック PDF、完全版ガイドラインのすべてで、各 font-family のフォント一覧に幅広い文字体系をカバーするフォールバックを含めてください。Chromium のグリフ単位のフォールバックを利用し、ラテン文字には選択したブランドフォントを維持しながら、CJK、アラビア文字、キリル文字、その他の文字体系には豆腐文字ではなく Noto ファミリーが適用されるようにしてください。最低限のフォント一覧は次のとおりです。ディスプレイ／セリフ体：BrandDisplay, "Noto Serif SC", "Noto Serif TC", "Noto Serif JP", "Noto Serif KR", "Noto Sans Arabic", serif。本文／サンセリフ体：BrandBody, "Noto Sans SC", "Noto Sans TC", "Noto Sans JP", "Noto Sans KR", "Noto Sans Arabic", system-ui, sans-serif。

3 つすべてを分かりやすく提示してください。1 つを選ぶか、異なる案の要素を組み合わせるようユーザーに尋ねてください。

ステップ 3 — 完全版ブランドガイドライン PDF の作成

ユーザーがボードを確定したら、14～16 ページのブランドガイドライン PDF を作成してください。自律型のフルモードでは、前提条件ログに記録したモデル選定のボードまたはハイブリッド案をもとに作成してください。

ページ数は条件によって異なります：

• 14 ページ — 単一メディアの画像を使用する非デジタルブランド（製品、レストラン、ファッション、サービスなど）。アイコンページは省略します。
• 15 ページ — 単一メディアの画像を使用するデジタルブランド（アプリ／ウェブ／SaaS）。アイコンページを含めます。
• 15 ページ — ハイブリッド画像（写真＋イラスト）を使用する非デジタルブランド。画像ページを 2 ページに分け、アイコンページは省略します。
• 16 ページ — ハイブリッド画像を使用するデジタルブランド。アイコンページと分割した画像ページの両方を含めます。

含める内容に応じて、ページ番号を連番に振り直してください。ページ番号に抜けを残さないでください。

ページ構成（全項目 — 上記の条件に応じて適用）：

1. 表紙 — ブランド名、タグライン、ブランドの世界観を伝えるメイン画像。全面に配置します。
2. 戦略とポジショニング — 方向性を示す名称。ポジショニングを表す一文（印象に残る簡潔な文章）。ターゲット層の体系：主要セグメント、二次セグメント（複数可）、そして主要セグメント内の具体的な人物像を1人。1人の、細かく限定しすぎた顧客だけを描写しないでください。「取り入れる要素」を記したメモとともに、参考ブランドを3〜4件挙げます。
3. ブランドの基盤 — ミッション。ブランドの価値観（3〜5項目）。「なぜこれが存在するのか」を伝えるストーリー（ブランドの語り口による、実際の文章を2〜3段落。テンプレートは使いません）。
4. ロゴ — プライマリーロゴとすべてのバリエーション（横組み、アイコンのみ、反転）。使用ルール（暗色・明色・色付きの背景）、ロゴマークの説明、クリアスペースのルール。
5. ロゴの禁止事項 — CSSで誤った使い方を明示します。伸縮、回転、誤った背景、色の変更、ドロップシャドウの使用は厳禁です。各違反例を視覚的に示し、「✗」ラベルを付けます。
6. カラー — すべての色見本にHEX・RGB・CMYKを記載し、基本の配色、アクセシビリティ／コントラストに関する注意点、避けるべき配色を示します。白地に色見本を浮かべるのではなく、色のカラムをページ全体に配置します。
7. タイポグラフィ — H1からキャプションまでの完全な階層（正確なピクセルサイズ）、ディスプレイ用／アクセント用／本文用フォント、用途ごとの使用ルール、色付き背景上での文字組み、最小サイズ。
8. アイコン (デジタルブランドのみ。製品、ファッション、レストラン、サービスのブランドでは省略) — UIアイコンシステム：ブランドの幾何学的なスタイルで描画した、必須アイコン8〜12個（arrow-right、check、close、plus、settings、search、user、bell、menu、infoなど）、ストローク／角／グリッドのルール、およびセットに含まれないアイコン用のライブラリの推奨。references/brand-guidelines.md の「Icons Page — Structure & Rules」セクションを参照してください。
9. ブランドの語り口とトーン — トーンを表す形容詞、文脈ごとのコピー例（見出し、本文、ボタン、エラー状態、SNSのキャプション）、使用禁止の単語／フレーズ。一般的な例文ではなく、実際のブランドコピーを示します。
10. イメージのルール — ブランドのメディアに合わせて調整します。写真主体 → 写真のルール（被写体／光／色／色調／質感／禁止事項＋写真例1点）。イラスト主体 → イラストのルール（スタイル／色／線／キャラクター／構図／禁止事項＋イラスト例1点）。ハイブリッド（写真とイラストを同等に使用）→ 2ページに分け、ガイドラインは16ページになります。references/brand-guidelines.md の「Imagery Rules Page — Adapts per Brand.」を参照してください。
11. ビジュアルの世界観 — ブランドのメディア構成（写真のみ、イラストのみ、または混在）に合った画像4点を、4カラムのグリッドでページ全体に配置します。人物が写る画像では、どのような場合も人種的に多様なキャストを起用します。
12. タッチポイント — 実写写真 — ブランドを実際の物理的な場面で見せる、実際に生成した写真4点の2×2グリッド。ブランドの種類に合わせて調整します。
    • 物理製品ブランド：衣服に付けたハングタグ、織りネームのマクロ写真、薄葉紙を入れたクラフト封筒、製品とパッケージのフラットレイ
    • デジタル／アプリブランド：アプリを表示したスマートフォンを手に持つ写真、サイトを表示したデスク上のノートパソコン、ウォーターボトルに貼ったステッカー、実際の場面で使われているトートバッグ
    • サービスブランド：手に持った名刺、デスク上のブランドノート、建物のサイン、実際の場面で使われているノベルティ このページではCSSベクターモックアップを使用しません。実際に生成した写真がないと、タッチポイントはブランドではなく、Figmaの練習課題のように見えてしまいます。実写画像は、ブランドが現実の世界でも通用することを示します。
13. ブランドの展開例 — CSSモックアップ — 二次的な展開例をCSSで描画したモックアップで示し、それぞれに仕様をラベルで記載します。名刺（寸法付き）、SNSアバター（円形にトリミング）、ステッカー／アプリアイコン（角丸四角形）、メール署名、プレゼンテーションの表紙スライド。製品ブランドの場合は、ハングタグの仕様、織りネームの仕様、ショッピングバッグの仕様も含めます。
14. デジタル／SNS — ウェブサイトのヒーローエリアのデザイン（色、フォント、レイアウトの印象）、Instagramのグリッドスタイル（色のパレットとキャプショントーンを含む3×3のモックアップ）、ストーリーテンプレート（ブランドカラー＋ロゴの配置）、リンクインバイオのレイアウト。
15. すること・しないこと — ブランド固有で実行可能な、推奨事項5項目と禁止事項5項目。一般論（「ロゴを正しく使う」など）ではなく、ブランド固有の内容にします（「SNS投稿ではワードマークの周囲に全角ダッシュ1つ分の余白を設ける。タグラインは単語の途中で切り抜かない」など）。 ページ 2（戦略）をページ 3（基盤）より前に配置し、どちらもロゴ／カラー／タイポグラフィのページより前に配置してください。戦略は、その後に続くすべてのビジュアル上の判断の枠組みとなります。

構成にはすべてのページを含めてください。ブランドにパッケージがない場合は、省略するのではなく、タッチポイントのページをブランドの種類に合わせて調整してください。ガイドラインでは、実際の状況でもアイデンティティがどのように保たれるかを示す必要があります。

完了ゲート： ガイドラインの PDF を短縮版や一部のみの形で納品してはいけません。6 ページに短縮したデッキ、Visual World ページの欠落、Touchpoints ページの欠落、または Brand Applications ページの欠落は、最終納品物ではなく、チェックポイントの不合格です。時間切れになった場合は、完了済みのページ、未作成のページ、生成済みアセットの URL、次に実行するレンダリング手順を記載した、再開可能なチェックポイントで作業を止めてください。必須ページがすべてレンダリングされ、QA に合格するまで、デッキが完成したと提示してはいけません。

references/brand-guidelines.md のすべてのビルドルールを適用してください。ローカルでのレンダリングルール、ページサイズを明示的に 1200×850 に指定すること、ローカルアセットとフォントの絶対パス、生成画像に重要なテキストを含めないこと、デッキ内で生成画像を重複使用しないこと、暗い背景でのテキストコントラストのしきい値、すべてのページについて送信前に必ずプレビューで QA を行うことが含まれます。

PDF で納品してください。 ~/Desktop/[brand-name]-brand-guidelines.pdf に保存し、ローカルパスをユーザーに伝えてください。ユーザーからホスト版を明示的に求められない限り、PDF をアップロードしたりホストしたりしないでください。ユーザーが Mac を使っていない場合は、プロジェクトの作業ディレクトリに保存し、返信でパスを伝えてください。

ステップ 4 — ブランドキットをエクスポートする（ハードゲート — ユーザーがガイドラインを明示的に承認した後のみ）

14〜16 ページのガイドライン PDF を納品した後、ブランドキットをエクスポートする前に、ユーザーからの明示的な承認を待ってください。自動でエクスポートしてはいけません。キットは最終的なブランドを確定するものなので、ブランドが確定してから作成してください。例外：自律型フルモードでは、明確なブリーフが一式の成果物すべてをすでに承認しているため、ガイドラインが QA に合格した後に brand-kit.zip をエクスポートしてください。

次に、ユーザーが Claude、GPT、Figma、デザイナー、開発者のいずれと作業する場合でも、ブランドに沿った制作ができる包括的なブランドキットの zip を作成してください。

キットの構成：

[brand-name]-brand-kit.zip
├── brand.md                       # comprehensive machine-readable spec
├── brand-guidelines.pdf           # full 14-16-page guidelines PDF (the visual deliverable)
├── README.md                      # 1-page how-to-use guide
├── logo/
│   ├── symbol/                    # standalone mark — RASTER ONLY, no SVG (symbol is generated PNG, not traced)
│   │   ├── symbol-[color]-16.png
│   │   ├── symbol-[color]-32.png
│   │   ├── symbol-[color]-64.png
│   │   ├── symbol-[color]-128.png
│   │   ├── symbol-[color]-256.png
│   │   ├── symbol-[color]-512.png
│   │   ├── symbol-[color]-1024.png
│   │   └── symbol-[color]-2048.png
│   ├── wordmark/                  # the brand name — vectorized via text-as-paths
│   │   ├── wordmark-[color].svg
│   │   └── wordmark-[color].png
│   └── lockup/                    # symbol + wordmark together at locked measurements
│       ├── horizontal/
│       │   ├── lockup-h-[color].svg
│       │   └── lockup-h-[color].png
│       └── stacked/
│           ├── lockup-s-[color].svg
│           └── lockup-s-[color].png
├── icons/                         # digital brands only — UI icons from the Icons page as SVGs
│   ├── arrow-right.svg
│   ├── check.svg
│   ├── close.svg
│   ├── plus.svg
│   ├── search.svg
│   ├── user.svg
│   ├── settings.svg
│   ├── bell.svg
│   ├── menu.svg
│   ├── info.svg
│   └── [+ any brand-specific icons]
├── fonts/                         # actual TTF font files (OFL-licensed Google Fonts)
│   ├── [display-font]-Variable.ttf
│   ├── [body-font]-Variable.ttf
│   └── README.md                  # license + install instructions
├── tokens/                        # design tokens for devs
│   ├── tokens.css                 # CSS custom properties — paste into :root
│   ├── tokens.json                # same content in JSON — for AI tools / CI
│   └── tailwind.config.snippet.js # paste into tailwind.config.js extend block
└── prompts/                       # AI prompts for downstream brand use
    ├── system-prompt.md           # paste at the top of a Claude/GPT thread for brand voice
    ├── tweet.md                   # task-specific starter: write a tweet
    ├── landing-hero.md            # task-specific starter: landing page hero copy
    ├── email.md                   # task-specific starter: marketing/transactional email
    ├── error-message.md           # task-specific starter: write a friendly error
    ├── photography.md             # task starter: generate brand-style photography (with cliché guardrails + brand-photography rules embedded)
    └── illustration.md            # task starter: generate brand-style illustration (only if the brand uses illustration as a medium)

エクスポートするカラーのバリエーション（ロゴごと）：ライト背景用のプライマリー、ダーク背景用のプライマリー、ライト背景用のニュートラル（インク）、ダーク背景用のニュートラル（クリーム）、アクセントカラーを使った組み合わせを 1 種類。通常、ロゴの種類ごとにカラーセットは 4〜5 種類です。

brand.md — 全体の構成は references/brand-md-template.md を参照してください。以下を含める必要があります。

• クイックリファレンスブロック（名前、タグライン、プライマリーカラー、フォント、ボイスを一目で把握できるセクション）
• ポジショニングとオーディエンスのセグメント
• ミッション、価値観、ストーリー
• ボイス＆トーン（形容詞、文脈ごとのコピー例、使用禁止語）
• カラー（HEX／RGB／CMYK／Pantone／用途を含む表）
• タイポグラフィ（ディスプレイ用＋本文用＋Google Fonts の URL＋完全な階層）
• ロゴ（ワードマークの説明＋シンボルの説明＋ロックアップ仕様＋パス付きのファイル一覧）
• 写真のルール
• ビジュアルワールドの説明
• タッチポイントの仕様
• Do & Don't の一覧
• 「これを参考にする」メモを添えた参考ブランド
• 下流のツールや担当者に仕様の適用方法を伝える使い方のセクション ロゴアセットの制作パイプライン：

1. シンボルアセット — シンボルは生成されたラスター画像のマークなので、PNG のみを書き出します。承認済みの 2048x2048 透過マスターから始め、アルファチャンネルが正しいことを確認してから、必要な色／背景のバリエーションごとに 16/32/64/128/256/512/1024/2048 の PNG を生成します。SVG にトレースしてはいけません。また、ベクターだと主張してはいけません。
2. ワードマークアセット — ブランド名を実際のフォントテキストとしてレンダリングし、選択したフォントのテキストをアウトライン化して wordmark-[color].svg にします。また、幅 1024 の透過 PNG フォールバックも書き出します。ワードマークは画像生成の成果物ではなくタイポグラフィなので、再現可能です。
3. ロックアップアセット — 承認済みのシンボル PNG とアウトライン化したワードマークを、指定された寸法で組み合わせます。PNG をインラインで埋め込み、ワードマークをパスとして含めた lockup-[orientation]-[color].svg を書き出し、幅 1024 の PNG フォールバックも作成します。色のバリエーション間でジオメトリを同一に保ちます。
4. 任意の印刷用 PDF — ユーザーまたは印刷業者から明示的に依頼された場合にのみ、PDF を追加します。PDF にはラスターのシンボルとベクターのワードマークを埋め込めますが、純粋なベクターロゴファイルではありません。
5. アイコン SVG — デジタルブランドのみを対象に、stroke="currentColor"、viewBox="0 0 24 24" を指定し、ブランドで選択した線の太さと角のスタイルを一貫して適用した、独立した SVG としてアイコンセットを作成します。含めるアイコンについては、references/brand-guidelines.md の「Icons Page — Structure & Rules」を参照してください。
6. デザイントークン — ブランド仕様から、次の 3 つのファイルをすべて生成します。
   • tokens.css — --color-*、--font-*、--font-size-*、--line-height-*、--space-*、--radius-*、--shadow-* のカスタムプロパティを含む :root ブロック
   • tokens.json — 同じ内容を、color、font、fontSize、lineHeight、spacing、radius、shadow のセクションを持つ JSON オブジェクトとして記述
   • tailwind.config.snippet.js — module.exports.theme.extend 内に貼り付ける JavaScript スニペット。colors、fontFamily、fontSize、borderRadius、boxShadow を含む
7. AI プロンプト — ブランドの詳細を反映して、各プロンプトファイルを生成します。
   • system-prompt.md — 任意の Claude/GPT スレッドの冒頭に貼り付けるシステムプロンプト。ブランドの声を表す形容詞、使用禁止語、コピーのルール、写真の方向性、色／フォントの仕様、ブランドの声の例を含めます。最後に「明示的に別の指示がない限り、常にこのブランドの声を適用してください。」と記載します。
   • tweet.md — タスクの開始用テンプレート。最大 280 文字、声に関する制約、目標とするツイートの例を記載し、その後に「Task: [USER FILLS IN]」を記載します。
   • landing-hero.md — タスクの開始用テンプレート。ヒーローコピーの構成（見出し＋サブ見出し＋CTA）、ブランドの声のルール、ガイドラインにある例を記載します。
   • email.md — タスクの開始用テンプレート。メールのトーン、件名の指針、本文の構成、結びの慣例を記載します。
   • error-message.md — タスクの開始用テンプレート。ブランドの声でエラー／空／読み込み状態をどう扱うかを記載します（温かみがあり、機械的でないこと。具体的で、曖昧でないこと）。
   • photography.md — ブランドが目指す写真の生成に使うタスクの開始用テンプレート（gpt-image-2 など）。次の内容を必ず含めます。ブランドの写真の方向性に合わせたマスタープロンプトテンプレート（被写体、光、カラーグレーディング、キャストの多様性、質感）、プロンプトで明示的に避けるもののリスト（スタジオストロボ、ストックフォト風の表現、ガラス張りのコワーキングスペース、「ノートパソコンを使うエンジニア」、「プロフェッショナル」、「プレミアム」など）、禁止する陳腐なコンセプトのリスト（砂時計、電球、握手、ネットワークノード、光る脳など）、「X をしている人」の代わりに使える被写体、品質要件（バター色のアクセント、多様性、フィルム粒子、ドキュメンタリー調）、明示的なテキスト禁止のガードレール文、実在する出版物の名前を決して出さないという注意。
   • illustration.md — ブランドがイラストを表現手段として使う場合のみ作成します。ブランドスタイルのイラストを生成するためのタスク開始用テンプレートです。厳格なパレットとスタイルのルール（フラットベクター／線画など）を含むマスタープロンプトテンプレート、禁止要素（グラデーション、ドロップシャドウ、3D、写真のような質感）、イラストと写真を使い分ける条件を記載します。ブランドのビジュアル表現にイラストがない場合は、このファイルを完全に省略します。
8. ブランドフォント — ローカルへの書き出し手順です。Google Fonts（またはブランドフォントの提供元）から実際のフォントファイルをダウンロードして、fonts/ に含めます。
   • 利用可能な場合は可変フォントファイルを使用します。[FontName]-Variable.ttf（全ウェイトに対応する単一ファイル）
   • または、ブランドで使用するウェイトの静的フォントを使用します
   • ローカルでレンダリングする HTML では、ローカルの TTF を絶対 file:// パスで使用します
   • ライセンス（再配布が認められている一般的なライセンスである OFL など）と、オンラインでのインストールに使用する Google Fonts の URL を記載した fonts/README.md を追加します
9. ブランドガイドライン PDF — ステップ 3 で作成した 14-16 ページのガイドライン PDF をキットに brand-guidelines.pdf としてコピーします。これがないキットは未完成です。
10. README.md — キットの内容、AI ツールで brand.md を使う方法、用途ごとに使うロゴファイル、フォントのインストール先（ローカルの TTF または Google Fonts の URL）、写真／イラストのプロンプトの使い方をユーザーに説明する 1 ページのガイドです。
11. すべてを ZIP 化します：zip -r [brand]-brand-kit.zip brand.md brand-guidelines.pdf README.md logo/ icons/ fonts/ tokens/ prompts/ ブランドキットの完了ゲート： ユーザーがエクスポートを確認した場合、または export_kit が --config に設定されている場合、ブランドキットの zip は必須の納品物です。 zip が存在し、brand.md、brand-guidelines.pdf、README、ロゴアセット、アイコン、フォント、トークン、 プロンプトが含まれるまで、ブランドキットを完了としないでください。必須ファイルを作成できない場合は、 再開可能なチェックポイントで停止し、不足ファイルを列挙してください。部分的な zip を納品してはいけません。

README.md — ユーザーに次の内容を伝える1ページのガイド：

• キットに含まれるもの
• AI ツールで brand.md を使う方法（Claude/GPT に貼り付けて、ブランドに沿った成果物を生成）
• 用途ごとに使用するロゴファイル（Web のファビコン → シンボル PNG、印刷物 → PDF、Web ヘッダー → ワードマーク SVG など）
• フォントのインストールリンク（Google Fonts の URL とローカルの TTF ファイル名）

納品：

• Mac のローカルユーザー向けに、zip を ~/Desktop/[brand-name]-brand-kit.zip に保存します。
• 環境上、フォントをダウンロードできない、またはローカルに zip を書き込めない場合は、部分的なキットを納品しないでください。 再開可能なブロック状態のチェックポイントで停止し、完了した成果物（ローカル PDF のパス、brand.md、トークン、ロゴアセット）、不足している ファイル、および正確なファイルシステム／ネットワーク上の阻害要因を列挙してください。
• ユーザーから明示的な依頼があった場合に限り、完成した zip をホストします。
• 完成した zip の内容をユーザーに伝え、解凍せずにプレビューできるよう brand.md へのリンクを提示します。

最終確認の品質ゲート

どちらの成果物についても成功を宣言する前に、ローカルのプレビュー画像をレンダリングし、構造化された判定を伴う体系的なビジュアル QA を実施してください。

• クイックモード：クイックブランドパッケージを納品する前に、quick-brand.pdf の PNG/JPG プレビューまたはコンタクトシートを確認します。
• フルモード：ローカル PDF のパスを納品する前に、ガイドライン PDF の承認に使用した最終ページの PNG/JPG プレビューまたはコンタクトシートを確認します。最終 PDF に対する analyze_media を主な QA 手段として実行しないでください。ページプレビューはページ単位のレイアウトを確認でき、大容量 PDF のラスタライズ失敗を避けられるため、QA 成果物として使用します。

Return JSON only: {
  "verdict": "clean" | "degraded" | "catastrophic",
  "observations": string[],
  "quality_warning": string | null,
  "re_roll_suggestion": string | null
}
Check that the brand name is spelled consistently, the `quick-brand.pdf` or guidelines PDF preview shows the required pages, low-contrast text is not present, the wordmark/symbol are not garbled, and there are no blank or duplicate-looking pages.

• verdict が clean の場合は、通常どおりクイックブランドパッケージまたはローカル PDF のパスを返します。
• verdict が degraded の場合は、ユーザーが公開前に確認できるよう、クイックブランドパッケージまたはローカル PDF のパスと quality_warning を返します。
• verdict が catastrophic の場合は、デッキを完了としないでください。成功を宣言する代わりに、判定と re_roll_suggestion を提示します。

主要な原則

• 入力がブリーフです。 長いヒアリングフォームを求めないでください。目の前にある情報を読み、的確な質問を3～5個してください。
• ブランドの対象顧客を具体化しつつ、1人に限定しないでください。 対象顧客が曖昧だと弱いブランドになりますが、特定の個人に絞り込みすぎると、成果物が使いにくくなる場合があります。まず顧客セグメントを定義します。主要セグメント、1～2個の副次セグメント、そして主要セグメントを具体的に感じさせる代表的なペルソナを1人設定してください。
• フルモードの主な選択ポイントでは、ボードを3つ提示します。 ステップ2では、テキストのみの方向性やテンプレートの色替えではなく、ビジュアルブランドボードを必ず3つ提示します。
• 明確な見解を示しつつ、協力的に進めます。 自分の見立てを自信を持って伝えます。ユーザーは異論を述べることができます。
• 実際のコピーを作成してください。[BRACKETS] を使ったテンプレートを渡してはいけません。ブランドの語り口に合わせて、実際の文章を書いてください。
• すべての画像は、リアルで丁寧に作り込まれた見た目にしてください。 生成するライフスタイル画像やタッチポイント画像には、フィルムグレイン、自然光、わずかな不完全さ、エディトリアルな構図を取り入れます。禁止事項：完璧な対称性、グラデーション背景、スタジオのストロボ、ストック写真のような雰囲気、AI 特有の滑らかな質感、白背景に浮かぶ物体。不自然に見える場合は、上記の画像再試行回数の上限内で再試行し、上限に達した後は再生成を続けないでください。
• 選択された深度ごとに、納品物のセットは1つです。 クイックモードではクイックブランドパッケージを納品します。インタラクティブなフルモードでは、ブランドガイドライン PDF を1つ納品し、ユーザーがガイドラインを確認した後に限り、オプションのブランドキットも納品します。自律型のフルモードでは、3つすべての成果物、つまりブランドボード、ガイドライン、ブランドキットを納品します。

---

ブランド品質基準

このスキルで制作するすべてのブランドは、以下の基準を満たす必要があります。成果物はテンプレートを飾るためではなく、実際のデザイン判断を導くためのものなので、ありきたりな出力は失敗です。

ありきたりでないかを見極める

何かを納品する前に、こう問いかけてください。文字どおり、ほかのどんなもののブランドにもなり得るでしょうか？ そうなら、まだ完成していません。

強いブランド ＝ 具体的な製品・サービス ＋ 明確なオーディエンス像 ＋ 独自の視点。弱いブランド ＝ 雰囲気 ＋ 美的なムードボード ＋ 中身のないタグライン。後者は決して納品しないでください。

コピーの基準

優れたブランドコピーの特徴：

• 具体的な主張をします。「厚手のウール。10年着られる一着。」／「毎日、静かな1時間のために作りました。」
• 独自の視点があります。「流行に追わない。大量生産もしない。」
• 特定のセグメントに属する読み手に、具体的に語りかけます。「スマートフォンを確認する前に手が伸びるアプリ。」これはコピーのスタイルであって、オーディエンス戦略ではありません。ブランドのオーディエンス像を、その読み手だけに限定しないでください。
• 緊張感や対比を生み出します。「手作り。使い古し。あえて。」
• 読み手を信頼します。過剰に説明せず、「どんな場面にもぴったり」や「心地よい雰囲気」といった表現は使いません。

質の低いブランドコピーの特徴：

• 「愛情を込めて作りました」／「丁寧に作りました」／「情熱を込めてデザインしました」
• 「どんな場面にもぴったり」／「時代を超えて愛される一品」
• 「触れればわかる品質」／「インスピレーションを与えるデザイン」
• ありきたりなタグライン：「品質とスタイルの融合」／「自分らしさを身に着けよう」
• 中身のない最上級表現：「プレミアム」「ラグジュアリー」「洗練された」「厳選された」「職人仕上げ」
• 言葉をひとつも変えずに、ほかの500のブランドにも当てはまる表現

タグラインのテスト： 優れたタグラインは、そのブランドにしか属し得ません。「手作り。使い古し。あえて。」はWORNのものです。「Just do it.」はNikeのものです。見知らぬEtsyショップやSquarespaceサイトに載っていても誰も気づかないようなタグラインなら、書き直してください。

デザインの基準

エディトリアルなブランドデザインの特徴：

• 明確なタイポグラフィの階層構造 — 何が最も重要かが一目でわかる
• 確信を持って使われた色 — 小さなアクセントではなく、大きな面で使う
• 写真が端まで広がっている — 影付きで浮かぶ画像は使わない
• スケールの対比 — ひとつの要素を主役にし、ほかは控えめにする
• ページにデザインの意図が感じられ、寄せ集めに見えない
• 余白に意図があり、デフォルトのパディングではない

ありきたりなブランドデザインの特徴：

• 同じ大きさのボックスをグリッド状に並べる
• 本文がほかのすべての要素と同じ大きさ
• すべてを中央揃えにする
• 白い背景に色付きのボックスをいくつか置く
• 角丸の写真が白い余白に浮かんでいる
• 「ここにフォント名」や「サンプルテキスト」と書かれたフォント見本
• 塗料店のパンフレットのようなカラースウォッチ

レイアウトのルール： CanvaやPowerPointで10分あれば作れてしまうようなページでは、質が足りません。すべてのページに、センスのある人にしかできないデザイン上の判断が必要です。

写真と多様性の基準

人物が写る画像セットを生成する場合は、人種の多様性を表現してください。これにより、すべてのブランドの世界観が同じ限られた顔ぶれに偏るのを防げます。

• 4枚以上のライフスタイル画像全体で、さまざまな人を登場させてください。黒人、アジア系、ラティーナ、南アジア系、中東系、または複数の人種的背景を持つ人々を含めてください。
• 肌の色だけでなく、体型にも変化をつけてください。
• 人物が1人だけの場合は、その人物を誰にするか意識的に選び、白人や肌の色が明るい人を無意識に選ばないでください。
• 多様性はチェック項目ではありません。ブランドに共感と誠実さをもたらすデザイン上の選択です。

写真には、演出された印象ではなく、その場で見つけたような自然さが必要です。

• 実際の暮らしが感じられる部屋（書類、植物、使い込まれた家具）
• 完璧ではない光（窓から差す光、曇りの日の光、早朝の光）
• 必ずフィルムグレインを加える — ほんの少しでも
• 強い意図がある場合を除き、被写体はカメラを見ない

デッキ／ガイドラインのデザイン基準

• タイポグラフィは必ず読み込んでください。実際のフォントファイルをダウンロードし、ローカルのレンダリング HTML では絶対パスの file:// パスを使用してください。レンダリングを承認する前に、フォントが読み込まれていることを必ず確認してください。フォントがシステムのデフォルトにフォールバックしている場合、そのデッキは不完全であり、納品できません。
• ローカルレンダリングの完全な仕様と QA ルールについては、references/brand-guidelines.md を参照してください。
• すべてのページで、何を最初に見るべきかが明確な視覚的階層を設けてください。
• 写真を全面に使うページは、スライドショーのスライドではなく、雑誌の見開きのような印象にしてください。
• カラーパレットのページでは、白地に浮かぶスウォッチではなく、画面いっぱいに広がる色の列を使ってください。
• ロゴのページでは、ロゴを思い切って大きく配置し、遠慮がちな小さなロゴではなく、バリエーションを明確に示してください。
• ブランドボイスのページでは、汎用的な例文ではなく、実際のブランドコピーを示してください。
• タッチポイントのページには、実際のタッチポイントを写した生成写真を必ず含めてください。CSS のボックスは使用しないでください。

ガイドラインは個別のページ画像ではなく、ローカルの PDF 1 つとして納品してください。キットを書き出す際は、PDF のパスを保存し、ブランドキットの zip にコピーしてください。

審美性のチェック

ブランドに関する成果物を納品する前に、次の点を自問してください。

1. センスのよい25歳の人が、このブランドから買いたい、このブランドを使いたい、このブランドで働きたいと思うでしょうか？
2. コピーは実際の人が書いたように聞こえるでしょうか？
3. デザインは本物のデザイナーが手がけたように見えるでしょうか？
4. 写真に多様性があり、自然に見えるでしょうか？
5. 独自の視点、つまり他のブランドにはない、このブランドが大切にしているものがあるでしょうか？

どれか1つでも答えに迷う場合は、納品前に改善してください。無難で一般的なものより、力強く具体的なものを常に優先してください。

---

重要なフレーズ

以下は、このスキルがありきたりなブランドブックの成果物に流れないようにするための要です。

フレーズ	場所	重要な理由
different business answer — not aesthetic variations	ステップ 2 のビジュアルボード	見た目のバリエーションより先に、ポジショニングの多様性を促します。
fonts must have character	ステップ 2 のビジュアルボード	無難なフォントがデフォルトになることで、どのブランドも同じ印象になるのを防ぎます。
no load-bearing text on generated images	ガイドライン作成ルール	ブランドの主張を編集可能かつ読みやすい状態に保ち、HTML／PDF で確実に表示できるようにします。
film grain, natural light, slight imperfections	画像品質基準	ライフスタイル写真やタッチポイント写真が、ストックフォトのように滑らかになりすぎるのを防ぎます。
Name a specific ethnicity per prompt	多様なキャストへの立て直し	一般的な多様性の指示よりも確実に、モデルが登場人物を全員白人にする傾向を修正します。

---

エンジンの選択：gpt-image-2（注意事項あり）

すべてのブランド画像では、デフォルトとして quality: "medium" の gpt-image-2 を使用してください。理由は以下のとおりです。

• キャストの多様性に関するプロンプトへの指示追従性が最も優れています（nano-banana-pro は、強く指示しないと白人をデフォルトにする傾向があります）。
• テキストを含めないためのガードレール遵守が最も優れています。これは、生成画像に文字が入るとモックアップが台無しになるハングタグ／織りラベル／ステッカーなどのタッチポイント写真で特に重要です。
• ネイティブの 3:4／4:3／9:16 の比率では、シャープな被写体を不自然に引き伸ばさず、きれいにトリミングできます。

このスキルでは nano-banana-pro を避けてください。プロンプトに「editorial」と含めると、商品写真に雑誌の表紙のような文字を焼き込んでしまいます。1200×850 の PDF ページなら、gpt-image-2 の 1K で十分です。特定のタッチポイントで印刷品質の解像度が本当に必要な場合に限り、gpt-image-2 の 2K ティアに上げるか、それ以上が必要なら seedream に切り替えてください。（gpt-image-2 の 4K は 16:9／9:16 のみです。このスキルの 3:4／4:3 の比率で 4K が必要な場合は seedream が使われます。）

実行時の想定

長い工程は進捗が分からないと停止したように感じられるため、開始前に所要時間の目安をユーザーに伝えてください。時刻を伝える場合は、必ず PST で示してください。

クイックブランドの目標

ステージ	目標時間	備考
受付と前提の確認	1-2 分	元の入力に不足がない限り、複数ターンにわたる質疑応答は省略します
1つの戦略とアイデンティティ	2-3 分	最も有力な方向性を選び、3案を検討する遠回りはしません
シンボル／ムード／タッチポイントのアセット	3-5 分	QA で問題が発生しない限り、生成画像は合計4点までです
クイック PDF とキットファイル	2-3 分	3ページの PDF、コンパクトな brand.md、トークン、プロンプト、利用可能なロゴアセット
簡易 QA と納品	1-2 分	PNG プレビューを確認し、納品を妨げる問題が見つかった場合のみ再レンダリングします

クイック目標の合計：使用可能な入力を受け取ってから8-12分。ユーザーの応答時間を除きます。

フルブランドブックの所要時間マニフェスト

フル実行ごとに、作業メモに所要時間マニフェストを記録し、最終納品物または再開可能なチェックポイントに含めます。以下の PST タイムスタンプを記録してください。

• 入力受領／モード選択
• 受付完了
• ビジュアルボードの下書き完了
• ブランドボードのレンダリング開始／完了
• ユーザーのアイデンティティ選択を確定
• 画像生成バッチ1の開始／完了
• 画像生成バッチ2の開始／完了
• ガイドライン全体のレンダリング開始／完了
• デッキ全体の QA 開始／完了
• ブランドキットのエクスポート開始／完了（依頼された場合）

再び所要時間が約2時間になった場合は、どこに時間がかかったかを推測しないでください。このマニフェストを使って実際に最も時間のかかったステージを特定し、その根拠を次回の改善に活用してください。

フルブランドブックの目標

ステージ	時間	備考
ステージ0 → ステップ1（質疑応答）	5–15 分	ユーザーのペースに合わせ、質問は1通のメッセージにまとめます
ステップ2（ビジュアルブランドボード3案の PDF）	6–10 分	ボードごとにシンボル＋ムード画像1点＋ローカル Chrome レンダリング
ステップ3の画像生成（gpt-image-2 による写真8点、4点ずつの並列バッチ2回）	8–12 分	最も時間のかかるステージです。各バッチは約4–6分です
ステップ3のページ作成（HTML ページ14-16ページ＋ローカルレンダリング）	2–5 分	Chrome headless を推奨し、WeasyPrint は代替手段です
ステップ4のブランドキット ZIP	3–5 分	シンボル PNG のサイズ違い＋ワードマーク／ロックアップの SVG＋PNG＋条件付きアイコン＋トークン＋フォント＋プロンプト

フル目標の合計：約25–45分の実時間。ユーザーの応答時間を除きます。最近の現場からのフィードバックでは、有料クリエイター向けチュートリアルの録画で、最初から最後まで約2時間かかったとのことです。これは達成すべき目標ではなく、改善すべき症状として扱ってください。

---

失敗への対処

generate_image で上流の 5xx が発生した場合の復旧

有料の生成またはレンダリングを行う MCP 呼び出しで、次のいずれかが返された場合：

• code: "provider_5xx" かつ retry_class: "retry_after_backoff"
• または上流の画像プロバイダーから HTTP 502／503／504

次の手順を実行します。

1. 5秒待ちます。
2. 引数を一切変えず、同じ MCP ツールをまったく同じ引数で再度呼び出します。プロンプトを書き換えたり、フォントを入れ替えたり、パレットや HTML、プロバイダーを変更したり、入力を再生成したりしないでください。
3. 再試行でも 5xx が発生した場合は中止し、次のようにユーザーに伝えます：「プロバイダーで一時的な上流エラーが2回発生しました。1-2分後にもう一度お試しください。通常は自然に解消します。」

再試行は1回を超えないでください。これは一時的な障害であり、ブランドの方向性の問題ではありません。クリエイティブブリーフを変更するとクレジットを無駄にし、再試行結果の比較も難しくなります。

上流の 4xx／moderation_blocked からの復旧

provider="gpt-image-2" を指定した generate_image で上流の 4xx または moderation_blocked が返された場合：

1. 同じプロンプトを再試行しないでください。モデレーションと、ほとんどの 4xx 検証エラーは再現性があります。
2. 失敗したアセットが生成されたシンボルまたはライフスタイル画像の場合は、ブリーフの意図を損なわない場合に限り、代替プロバイダーを1回だけ試します。高解像度のブランド画像には seedream、シンプルな幾何学シンボルにはインライン SVG マークを使用してください。
3. 代替プロバイダーも失敗した場合、またはブランドの方向性が大きく変わってしまう場合は、次のようにユーザーに伝えます：「画像プロバイダーがこのブランド画像のプロンプトを拒否しました。認識されやすい参照を避け、実在する出版物や有名人を連想させる要素を削除するか、SVG／シンプルなマークの代替案を承認してください。」

上流の429（レート制限）からの復旧

上流のいずれかがバックオフのヒントとともにHTTP 429を返した場合：

1. 指定されたバックオフ時間だけ待機します。ヒントがない場合は30秒待機します。
2. まったく同じ引数で、同じMCPツールを再度呼び出します。
3. 再試行は1回までです。それでも429が返された場合は中止し、追加の呼び出しを行わずにレート制限メッセージを表示します。

capture_websiteが空またはページ未読み込みを返す場合

このスキルは通常、ユーザーの回答と提供されたアセットをもとに構築しますが、URLを参照元とする場合や、今後追加されるインテークヘルパーでcapture_websiteを呼び出すことがあります。capture_websiteが200を返しても、action_bboxesが空、またはrecording_viewportが0x0の場合：

1. 再試行しないでください。キャプチャ環境でページのレンダリングに失敗しています。
2. 次のメッセージを表示します：「をキャプチャできませんでした。ページがブロックされている、ペイウォールの対象になっている、または認証が必要な可能性があります。代わりにスクリーンショット、ロゴ、またはホストされたアセットを提供してください。」

task_status が上限時間を超えて長時間実行される場合

非同期 MCP 呼び出しはそれぞれ、インライン結果、またはポーリング用の {task_id, status} を返します。タスクが停止していると判断する前に、以下の上限時間を使用してください。

• gpt-image-2 の高品質：呼び出しごとに 3 min
• Seedream の画像生成：呼び出しごとに 3 min

プロバイダーの上限時間の 1.5 倍、またはスキル固有のポーリング上限のいずれか早い方を使用してください。その早い方の制限時間を過ぎても task_status が status: "processing" または status: "queued" を返す場合は、task_cancel({task_id}) を呼び出し、「プロバイダーの処理に通常より時間がかかっています。中止します。もう一度お試しください。」と伝えてください。

症状	原因	対処法
PDF のフォントが Times / Arial で表示される	@font-face が存在しない、または相対パスのローカルパスを参照している	TTF をローカルワークスペースにダウンロードし、絶対 file:// パスで指定してから、PDF 全体を生成する前に 1 ページのローカルプレビューを作成する
生成画像に雑誌名や透かしが埋め込まれている	プロンプトに「magazine cover」、「Vogue」、「TIME」、「Bloomberg」、または実在する出版物が含まれていた	プロンプトから出版物名を削除し、テキストなしのガードレールをそのまま追加して、画像生成の再試行回数の上限内で 1 回再生成する。出版物ではなく、見た目の特徴を説明する
タッチポイント／ライフスタイル写真が額だけ、または手だけの切り抜きになる	9:16 のポートレート画像が横長のセルに合わせて切り抜かれた	セルのアスペクト比に合うよう aspect_ratio: "4:3" または "16:9" を指定して再生成する、またはレイアウトをポートレートセルに変更する
ページが 850px の上限を超える	同じページに 60px を超える見出しと 3 段落を超える本文がある	内容を削る、見出しを 48px に小さくする、または 2 ページに分割する。再レンダリングし、スクリーンショットで確認する
ボードは技術的には収まっているが、見た目がよくない	装飾が多すぎる、文字が小さい、単調で濁った配色、空のモックアップ、または階層構造が弱い	brand-identity.md の予算に合わせてボードの文言を書き直し、装飾的な極小文字を取り除き、本文を 18px 以上に拡大し、余白とコントラストを加えて、PNG の生成とビジュアル QA を再実行する
テキストがアイコン／色見本／印章／モックアップと重なる	装飾要素または絶対配置された要素が、テキストと同じ読み取り領域を占めている	テキスト用の読みやすいカラム／カードを確保し、グラフィックはテキストのない領域の背後にのみ配置して、再レンダリングする。兄弟要素のグラフィックがテキストを覆っている場合、scrollHeight を通過しても不十分
複数ページのボードが、色を変えただけのテンプレートに見える	同じテンプレートを配色だけ変えて再利用している	references/brand-guidelines.md の「Brand Board Layout — Differentiate per Option」に基づいて作り直す。各ボードのレイアウトには、それぞれのデザイン思想を具体的に反映させる
複数ページの結合に失敗する	pdfunite またはローカルの結合ツールがない	1 つの完全な HTML ドキュメントに対して Chrome の --print-to-pdf を使用するか、Python の pypdf.PdfWriter().append() に切り替える
ユーザーがハイブリッドなアイデンティティ（「02 の配色 + 01 の語り口」）を選ぶ	スキルが単一案の選択を前提としている	ステップ 3 の前にハイブリッド仕様の概要を作成し、14～16 ページをレンダリングする前にユーザーに確認する
ユーザーがホストされた PDF を求めているが、アップロードに失敗する	PDF のアップロード先では application/pdf が拒否されることが多い	ローカル PDF を正式版として保持する。ホスティングが必要な場合は、ユーザーが承認したファイルホストまたはデプロイ先を使用する
多様な出演者を使うルールがあるにもかかわらず、ライフスタイル画像のグリッドがすべて白人に見える	プロンプトで民族性を明示しない場合、gpt-image-2 は肌の色が明るい人物をデフォルトで生成する	各プロンプトで具体的な民族性（Black、複数の人種的背景を持つ東アジア系と白人のミックス、East Asian、Latina、South Asian、Middle Eastern）を指定する。4 つのグリッド用プロンプトで変化をつける