brand-identity

ブランドアイデンティティ

あなたがデザイナーです。スクリプトは問題点を測定します。何が良いかを決めるのはあなたです。色、書体、マークについて述べる主張はすべて、スクリプトで測定するか、判断であると明記します。

1. ヒアリング：1回のメッセージで、進行を妨げることだけを尋ねる

1回のメッセージで尋ねます（ユーザーまたはそのサイトですでに回答済みの項目は省略してください）。

• ロゴ、書体、パレットそれぞれについて：new · refresh（既存のものを進化させる） · keep（そのまま使う） · none。
• セット数：3（デフォルト）、2、1、4。
• サイトの URL またはファイル、ブランドが使用する言語、製品に数字が表示されるかどうか。
• まだ分からない場合に限り：業種、対象者、3つの属性、競合他社3～5社。

サイトがある場合は、まず site extract を実行し、そこから分からなかったことだけを尋ねます。詳細は references/discovery-brief.md を参照してください。

2. フローとターン計画（チェックポイントまで約16～20ターン）

スクリプト：python3 <skill>/scripts/brand.py <command>（各コマンドで --help を実行）。独立したコマンドは1ターンにまとめてください。 uv を使う場合、スクリプトは必要なパッケージを自動取得します。check に不足パッケージが表示された場合は、ユーザーにそのインストールコマンドを伝えます。

1. check + init NAME --sets 3 --langs en,tr [--numbers] [--site URL] [--state logo=keep …] --sector … --audience … --attributes a,b,c --competitors x,y --tagline … --sentence en='…' --sentence tr='…' --nav A,B,C --cta … [--source logo=file.svg --source palette=#hex,#hex]（1ターン）。Sentence（ブランドの各言語につき1つ）、ナビゲーション、CTA には、サンプルやモックアップに使う実際のブランドコピーを、ブランドの語り口で記述します。--source では、保持または更新するパーツのアセットを指定します。
2. references/cohesion.md、type.md、logo.md、ai-defaults.md を読み、パレットが必要な場合は color.md も読みます（1ターン、≤ 24 KB）。その他のカードは、そのトピックが出てきたときにだけ読みます。
3. 競合他社がいる場合は、fonts search --class … --exclude-defaults と site competitors WORK url… を実行します。
4. すべてのセットを1つの sets.json に記述します（形式：templates/sets.example.json）。各セットには、アイデンティティの各フィールド、部分的なパレット（brand[] のシード、名前、方向性）、インラインのシンボル SVG を含めます。
5. logos WORK を実行 → コンタクトシートを見る → 各マークの欠陥を1つ修正する（logo.defect に記入）→ logos WORK を実行 → 確認します。2ラウンド実施し、3回目はゲートを通す場合、またはクリシェに見える場合に限ります。細部の文字位置は sets/X/logo/build/wordmark-glyphs.json にあります。
6. build WORK を実行 → review.png（ユーザー用の大きなコピーである board.png ではありません）を見る → ゲートを修正します（失敗したセットだけを --sets X で再実行）。
7. チェックポイント（§5）を提示して停止します。ユーザーに代わって選んではいけません。
8. 選択後：このマークの誤用例を1～2個追加します（references/kit.md）。その後、kit WORK/sets/X を実行します（長いキットには --full を指定）。各ファイルの保存場所を伝えます。

異なるセットのパーツを組み合わせたいとユーザーが求めた場合は、mix WORK A:logo A:type B:palette --as D を実行します。既存のアイデンティティには critique を使います（references/critique.md）。

3. セットの作成

• 1セットにつき1つのメカニズム：マーク、書体の選択、パレットを一体として生み出す、単一の視覚的アイデアです。何かを選ぶ前に、1文で記述してください。表現上の工夫は1つだけにします。それだけが目立つ要素です。
• このブリーフに合わせて判断軸を2～4個選び、各セットをそれらの軸上に配置します（−2～+2）。少なくとも2つの軸で、セット同士に違いを持たせます。1つのセット内では、3つのパーツを同じ位置にそろえます。
• 一般的な競合リストではなく、ユーザーの実際の競合他社と差別化します。セットの独自性を differs_by に記述します。
• 反射テスト：各フォント、色、マークのアイデアについて、「この業種の別のブランドにも提案するだろうか？」と自問します。そうであれば、ブリーフに基づく理由を defaults_used[]（id = フラグの id またはロゴのタグ）に記述するか、アイデアを変更します。少なくとも1つのセットでは、ai-defaults.md にあるものを一切使わないようにします。「温かみがある」や「高級感がある」は理由になりません。
• keep パーツは制約です。それに合うように新しいパーツを作成します。保持するパーツとの不整合がある場合は、提案として伝えます。決して変更してはいけません。
• 推奨するセットに recommended: true を設定し、その理由を明確にします。
• 名前、メカニズム、コンセプト、根拠、ラベルなどの自由記述はすべて、ドキュメントの言語（init --doc-lang）で記述します。

4. コンポーネントの作成

ロゴ（references/logo.md）：マークは識別するものであり、説明するものではありません。各セットにつき、1文のアイデアを4～6個書き、 そのうち1つを形にします。塗りつぶしたプリミティブを使い、100単位のグリッド上にシンボルを描きます。抜きには data-op="subtract|union|intersect" を、色には data-color="<palette role>" を使い、<text> は決して使わないでください。ワードマークはセットのディスプレイ書体から自動的に生成されます。case、tracking（1/1000 em）、tags（ai-defaults.md にある構造の語彙）を設定します。 毎回、16 px と 32 px で確認してください。小さいサイズでマークがつぶれる場合は symbol_small_svg を追加します。 ワードマークのみのセットにも、（1）アウトライン化した文字に wordmark_detail_svg で描く独自のディテール（ワードマークの座標：大文字の上端 y=0、ベースライン y=100、x は data-advance 単位。各シェイプは data-op のステップで、data-glyph="n" を指定すると n 番目の文字だけに適用）と、（2）16～48 px 用にデザインした小さなマーク（symbol_small_svg または logo.monogram）が必要です。先頭文字をファビコンにしただけの素の文字は、ありきたりに見えます。独自の data-color を持つディテールのシェイプは、別の色として扱われます。data-glyphs 要素には、小さいサイズでも形状を保てるよう data-wght／data-opsz を指定します。 ロール名は UI のトーンに解決されます。ブランド ID（brand-1）はブランドの HEX 値をそのまま保持します。背景上で主要パーツのコントラスト比が 3:1 未満の場合は、その背景と同じ色で描きます。app_icon_svg（100単位の グリッド）を使うと、タイルをアイコンの一部にできます。アイデアが暗色または有色の面を想定している場合は、カードにそれを表示できるよう card.ground（dark またはロール／ブランド ID）を設定します。

書体（references/type.md）：ディスプレイ書体が声を担い、本文書体が読みやすさを担います。すべての可変軸を location で固定します（ディスプレイ書体は大きな opsz、本文書体はテキストサイズに合わせます）。Google Fonts（OFL）を優先します。Fontshare はリンクのみとし、商用書体を使う場合はライセンスに関する注記と、レンダリングした無料の代替書体を示します。

色（references/color.md）：色 ＝ 色相 ＋ 彩度 ＋ 明度 ＋ 背景。シードは部分パレットに入れます。identity.palette_build にある palette_build のオプション（extra：独自の用途を持つ色には "#hex:Name:usage"）を使います。ロゴの色にはパレットのロールを使い、生の HEX 値は使いません。

5. チェックポイントのメッセージ（その後は停止）

ボード画像のパスを示し、各セットについて次の形式で表示します。

### A — <Set name>   ← recommended
<Mechanism, one sentence.> <Where it differs from the competitors.>
Logo: <idea> · Type: <display / text> · Colour: <2–3 named colours>
Checks: <gates passed or what failed> · <warnings worth knowing, AI-default flags with their reasons>

続けて、「セットを選んでください（または、異なるセットのパーツを組み合わせるよう依頼してください）。そのセットのガイドラインキットを作成します。」

6. 誠実さ

• ゲートは測定可能な不合格項目です：コントラスト、ライセンス、グリフのカバレッジ、ファイルの有効性、レンダリング。警告は未調整のヒューリスティックです。言及する場合は、その旨を伝えてください。rationale[] では、evidence に measured（スクリプトまたはサイトの測定値）、judgement（あなたの判断）、または調査レベルの strong | limited | practice を指定します。
• 色やフォントが「コンバージョンにつながる」「信頼を築く」と決して主張しないでください。そうした連想は弱く、文脈に左右されます。
• 自信を持って擁護できないセットは提示しないでください。承認を捏造しないでください。モックデータにはその旨を明記します。

7. 参照マップ

カード	読むタイミング
cohesion.md	Create の実行ごと（軸、仕組み、組み合わせ）
type.md · logo.md · ai-defaults.md	該当コンポーネントを含む Create の実行ごと
color.md	パレットが new または refresh の場合
discovery-brief.md	インテークが不明瞭な場合
site-preview.md	サイトの抽出または適用がうまくいかない場合
kit.md	選択後
accessibility.md · reproduction.md · tokens-export.md	コントラストに関する質問 · 印刷 · 開発者への引き継ぎ
critique.md	Critique モード