brand-mod

Brand Mod

将成熟品牌转换为 Claude Code Mod：Claude 工作时，终端和桌面应用会展示品牌的颜色、文字和徽标。绝不盲目发布。先用 HTML 展示并获得批准，再生成。

开始之前

先加载品牌包。 查找 brand.yaml（位于 ./、./brand/ 或 brands/<slug>/）；读取它，以及同一文件夹中的 identity.md（调色板）和 voice.md（词汇）。还没有品牌包？运行 brand-init，然后运行 brand-identity 和 brand-voice。至少需要一种主色和一个 SVG 徽标。

确认团队使用 Claude Code（终端，或桌面应用的 Code 标签页）。Mod 是 Claude Code 插件；它们无法在 Cursor、claude.ai 聊天或其他 Agent 中运行。先询问，不要想当然。

步骤

1. 在品牌包中编写 mod.json（架构见 scripts/brand-mod.py 的文档字符串）：
   • 使用 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（两个窗口：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（词汇、语气）中选取，而不是围绕品牌名称玩双关。
• 删掉没人会说的词。测试中，生造短语（“herding subagents”“big-braining”）和品牌双关（“Cofounded”）一旦被人看到，就显得很牵强。
• 轮次结束时显示 « for 12s»（引擎会添加 “for”）。“Shipped”“Cooked”这类过去分词就适用。
• 发布前，让团队成员读一遍词语列表。

此 Mod 的功能

• 终端： 三个立方体组成一个 2×2 方阵，方阵有旋转的缺口，之后显示阶段词语；品牌色阶中的一道微光扫过方阵和词语。在 Ghostty 或直接运行的 kitty 中，徽标位于右侧边缘（kitty 图形）；在 herdr、tmux、zellij 或 screen 中，不显示徽标，也不使用替代图案。
• 桌面应用（Code 标签页）： 显示带柔和 SMIL 扫光效果的徽标；浅色主题使用彩色徽标，操作系统处于深色模式时使用浅色徽标；词语使用一种易读的颜色。
• 轮次结束： 使用品牌的 done 词语，而不是 “Baked”。
• /<slug>-spinner off 会恢复 Claude Code 自带的旋转动画，并记住此设置。

设计决策及其背后的失败案例：method.md。完整示例：examples/cofoundy/（品牌包、mod.json、带 README 的生成式 Mod）。

相关技能

• brand-identity — 此技能读取的调色板和徽标方向。
• brand-voice — 微调词语的词汇来源。
• brand-guidelines — 将此模组的预览添加到品牌手册的应用部分。