brand-mod

ブランドモッド

完成したブランドを Claude Code モッドに変換します。Claude の作業中、ターミナルとデスクトップアプリにブランドの色、言葉、ロゴが表示されます。確認せずに公開することはありません。HTML で見せて承認を得てから、生成します。

始める前に

まずブランドパッケージを読み込みます。 brand.yaml（./、./brand/、または brands/<slug>/ にあります）を探し、同じフォルダーにある identity.md（パレット）と voice.md（語彙）を読みます。パッケージがまだありませんか？brand-init を実行し、続けて brand-identity と brand-voice を実行してください。少なくともプライマリーカラーと SVG ロゴが必要です。

チームが Claude Code を使っていることを確認します（ターミナル、またはデスクトップアプリの Code タブ）。モッドは Claude Code のプラグインであり、Cursor、claude.ai チャット、その他のエージェントでは動作しません。思い込まずに確認してください。

手順

1. ブランドパッケージ内に mod.json を作成します（スキーマは scripts/brand-mod.py の docstring にあります）。
   • identity.md の primary を指定します（スクリプトがグリント用に 8 トーンのスケールを導出します）。ブランドにすでにスケールがある場合は stops を指定します。
   • assets/ にある logo_svg（カラーのロゴ：デスクトップアプリ、ライトテーマ）と logo_light_svg（ライトカラーのロゴ：ターミナルとデスクトップのダークテーマ）を指定します。
   • ターンの各フェーズに対応する words と、ターン終了時の done を指定します。下記の 言葉 を参照してください。
   • name、slug、ドメインは brand.yaml の値を使います。重複して記載しないでください。
2. 生成します： python3 scripts/brand-mod.py <package>/mod.json --media --check <package>/mod/<slug>-spinner/ に、インストール可能なプラグイン（独自のマーケットプレイスも含む）、preview.html、GIF を先頭に配置した README.md、media/ が生成されます。--media には agent-browser と ffmpeg が必要です。--check は claude plugin validate と claude plugin test を実行します。どちらも省略可能です。rsvg-convert がない場合、ターミナルにはロゴが表示されません。
3. プレビューを見せます： preview.html を開くか共有します（2 つのウィンドウ：Ghostty とデスクトップアプリ、ライト／ダークの切り替え、「inside herdr」の切り替え）。ホストで HTML ページを公開できる場合（例：Claude Artifacts）は、公開してリンクを共有します。
4. 承認を得ます： オーナーがプレビューを承認するか、変更を依頼します。変更は mod.json に反映して再生成します。hooks/brand.ts を手作業で編集したり、承認前にインストールまたは公開したりしないでください。
5. 公開します： 生成されたフォルダーをリポジトリに入れます。その README にはインストール手順と /<slug>-spinner on|off コマンドが記載されています。brand.yaml で artifacts.mod: true を設定します。

言葉

• チームが実際に使う言葉を、チームの言語で選びます。各フェーズにつき 3～6 個です（thinking、tool-use、tool-input、responding、requesting）。ブランド名をもじった言葉ではなく、voice.md（語彙、トーン）から選んでください。
• 誰も使わない言葉は削除します。テストでは、作り物のフレーズ（「サブエージェントを群れさせる」、「頭脳をフル回転させる」）やブランド名のもじり（「Cofounded」）は、目にした途端に不自然だと受け取られました。
• ターンの終了時には「 を 12 秒間」と表示されます（エンジンが「for」を追加します）。過去分詞が適しています（「Shipped」、「Cooked」）。
• 公開前に、チームの誰かにリストを読んでもらってください。

モッドの動作

• ターミナル： 3 つの立方体でできた 2×2 の正方形が、隙間を回転させながら表示され、その後にフェーズを表す言葉が表示されます。ブランドのスケールから選ばれた 1 つのグリントが、正方形と言葉の上を横切ります。Ghostty または kitty を直接実行している場合は、右端にロゴが表示されます（kitty graphics）。herdr、tmux、zellij、screen ではロゴも代替表示もありません。
• デスクトップアプリ（Code タブ）： ソフトな SMIL の光が走るロゴが表示されます。ライトテーマではカラーのロゴ、OS がダークモードの場合はライトカラーのロゴが表示され、言葉は読みやすい 1 色で表示されます。
• ターンの終了時： 「Baked」の代わりに、ブランドの done の言葉が表示されます。
• /<slug>-spinner off を実行すると Claude Code 独自のスピナーに戻り、その設定は保持されます。

設計上の判断と、その背景にある失敗例：method.md。動作例：examples/cofoundy/（パッケージ、mod.json、README を含む生成済みモッド）。

関連スキル

• brand-identity — このスキルが参照する配色とロゴの方向性です。
• brand-voice — スピナーの単語の由来となる語彙です。
• brand-guidelines — ブランドブックのアプリケーションセクションに、mod のプレビューを追加します。