テーマ・キャラクター・遊びのモード
BeesBuild の見た目は、全部テーマで変えられます。既定は、暗い見た目（graphite）と、少し立体の SVG のミツバチです。明るい見た目に変えることも、自分で作ったテーマで、キャラクター・世界観・声までそろえて置き換えることもできます。テーマのファイルは Claude Code などの AI でまとめて作り、置くだけで反映できます。
かわいい見た目は、そういうテーマを選んだ人にだけ出ます。既定の見た目は、管制室の質の洗練です。
テーマの細かい所（包みの形・変えられる範囲・状態の色・外から来たテーマの確かめ方・文の調子・作る道具）は、決めているところです。設計中
エージェントのテーマ
エージェントの見た目は 3 つから選べます。
| テーマ | 中身 |
|---|---|
| ミツバチ（標準） | 少し立体のミツバチ |
| 作り手のテーマ | 自分のテーマのキャラクター |
| なし | 線と点だけ |
役と AI の印
ミツバチは、冠のセルの数で役を、胸の印で AI を表します。
| 役 | 冠のセル |
|---|---|
| 全体の統括 | 4 |
| ハイブの女王 | 3 |
| ブロックの統括 | 2 |
| 開発スレッド | 1 |
| サブエージェント | 0（いちばん下の小さな蜂） |
胸の印は、Claude Code・Codex・Antigravity（Gemini）・GitHub Copilot・DeepSeek などの AI を表します。素材に無い AI は、無地の印と文字の札にします。役の印と AI の印は、どのテーマでも BeesBuild が上に重ねて描きます。状態が変わっても、AI の印は変えません。
大きさと動き
| 置く所 | 大きさ |
|---|---|
| 一覧・地図 | 16〜32px |
| 札 | 48〜96px |
| 大きい絵 | 160〜320px（最初の設定・速さのレポート・紹介だけ。数字と表は隠さない） |
| 時 | 動き |
|---|---|
| 待つ・移る | ゆっくり上下し、−7 度に傾ける |
| 完了 | 0.8 秒で 1 回はねる |
| 動きを減らす設定 | 止める。状態と文字は残す |
「印を付けた（済み）」の絵は、終わりを機械で確かめた後にだけ出します。人の番が 0 の時は「全部のエージェントが動いています」と出します。
テーマの包み
テーマは「データだけの包み」です。1 つのフォルダーに、次の物を置きます。
| 物 | 中身 |
|---|---|
theme.json | 目次（id・名前・版・説明・ライセンス・借りる元・モード・部分） |
tokens\dark.tokens.json・light.tokens.json | 色と大きさの値。W3C のデザイントークンの形（DTCG 2025.10） |
fonts\・icons\・art\ | フォント・アイコン・背景の模様と空の画面の絵 |
characters\ | 仲間の目次（cast.json）と、仲間ごとの絵と Rive |
sounds\・voice.json | 音と声の組 |
copy\ | 文の調子と世界観の文 |
LICENSES\・README.md | ライセンスとクレジット・説明 |
JavaScript・CSS・HTML は入れられません。CSS を受けると、外の URL で情報を漏らす・確認のカードや危ない印を隠す・偽の画面を重ねる、ができてしまうからです。
置き場
| 置き場 | 中身 |
|---|---|
| アプリの中 | 同梱のテーマ（graphite・paper・honey-buddy）。読むだけ |
%APPDATA%\BeesBuild\themes\<名前>\ | 自分のテーマ。置けば一覧に出る |
| 設定で足した置き場（3 つまで） | Git のリポジトリの中など。Claude Code なら作業のフォルダーの中に書けばよい |
%LOCALAPPDATA%\BeesBuild\theme-cache\ | 点検を通った写しと、前の良い版（5 つまで）。画面はここだけを読む |
同梱のテーマ
| graphite（既定） | paper | honey-buddy（見本） | |
|---|---|---|---|
| モード | 暗い | 明るい | 明るいと暗い |
| 色 | 管制室の暗い地 | 白い地。「人が要る」は塗りの札 | はちみつ色の地 |
| 仲間 | 既定のミツバチ | 既定のミツバチ | 丸い顔の蜂 2 体 |
| 声と音 | 声の設定のまま・音なし | 同じ | VOICEVOX の話者 2 つ（クレジットつき） |
| 完了の演出 | 静かな光 | 同じ | 光の粒 |
3 つとも、ビルドのたびに点検を通します。
変えない所
守りの画面がテーマでごまかされないよう、次の物はどのテーマでも変えません。
- 確認のカード・鍵・お金・権限・本番・消す・エラーの画面の形と文
- 製品の名前と印（7 つの六角形）。色の変わりだけ選べる
- 状態の形の印（▲●✓✕◆◌）と文字の札
- 動きを減らす設定（OS の設定と、動きの量の自動調整がいつも先）
色の役と基準
色は役の名前で書きます。画面の部品は「どの役の色か」だけを知り、値はテーマが決めます。部品が色を直に書くことは、点検で止めます。
| 役の名前 | 使う所 | 基準 |
|---|---|---|
color.surface.* | 地・板・浮き・マウスを乗せた時 | 字が 4.5:1 になる地 |
color.text.1〜3 | 本文と題・説明・小さな注 | 4.5:1 |
color.line.control | 入力欄とスイッチの縁 | 3:1 |
color.state.human・ai・review・ok・danger | 人が要る・AI・レビュー中・済み・危ない | 字 4.5:1・形 3:1 |
color.state.mute | 信号なし（形と線だけ。字に使わない） | 3:1 |
color.fill.* | 主のボタン・許可のボタン | 4.5:1 |
color.bee.* | ミツバチの色だけを変える段 | 3:1 |
guard.* | 確認のカード・鍵・お金・権限の画面 | テーマで変えない |
- 字は 4.5:1、形・縁・焦点の輪は 3:1 を、暗い・明るいの両方で点検します。
- 明るい見た目では、「人が要る」を塗りの札で示します。濃い琥珀の字と赤の字は、緑が見えにくい人の目には近い色に見えるためです。
- 状態の色は、色覚の 3 つの型でも見分けられるかを点検します。色だけでなく、形の印と文字でも状態を示します。
文字・角・動き
| 物 | 変えられる範囲 |
|---|---|
| 文字 | 好みのフォントの順。最後に日本語のフォントを必ず足す。大きさは 1.0〜1.25 倍（小さくはできない）。数と ID は等幅のまま |
| 角と密度 | 角は小 0〜8・中 0〜14・大 0〜20px。押す所は 24×24px 以上 |
| 動き | 決まった型（きびきび・やわらか・静か）と範囲の中の数だけ。点滅は禁止 |
| アイコン | 左のメニューと道具のアイコン。状態の印と AI の印は置き換えない |
| 背景 | 六角形の格子の模様を、濃さ 0〜6% の SVG に置き換えられる |
ハチを置き換える 3 つの段
| 段 | 変える物 | 要る物 |
|---|---|---|
| そのまま | なし | なし |
| 色だけ | 体・羽・帯・目の色 | color.bee.* |
| 自分の仲間 | 絵（SVG・PNG・Rive） | 仲間の目次と最小の組 |
- 最小の組：1 体 × 6 つの状態（待つ・働く・待たされる・止まっている・済み・オフライン）× 4 つの大きさ（全身と、小さな絵 16・24・32px）。表情・口の形・大きい絵・Rive は任意です。
- 足りない状態は、近い状態の絵で代わりに出します。例えば「飛んでいる」は「働く」の絵を BeesBuild が −7 度に傾けて出します。
- 役の表示名（例：「ハイブの案内役」）は、画面に出す名前だけを変えます。命令や記録の名前は変えません。
Rive の約束
| 項目 | 中身 |
|---|---|
| 絵の台（artboard） | Agent |
| 状態の機械 | Main |
| ビューモデル | Agent。BeesBuild が書くのは 8 つの欄だけ（state・expression・viseme・rank・provider・speaking・reducedMotion・hop） |
| 大きさ | 1 つ 4MB まで |
| 受けない物 | Rive の台本（Luau）・音・文字を使う物。台本を含まない小さな版で動かす |
地図のように蜂が多い所では、小さな SVG だけを使います。
声・音・文の調子・完了の演出
| 物 | 中身 |
|---|---|
| 声 | エンジンと話者の参照と数だけ（声）。テーマを当てる時、声もそろえるかを 1 行で聞く |
| 音 | 知らせ・人が要る・済み・危ない・島のクリア・常駐エージェントを開く の 6 つ。2.0 秒まで。既定は鳴らさず、静かな時間（22:00〜7:00）・話している時・入力中も鳴らさない |
| 文の調子 | 一人称・ていねいさ・語尾・絵文字の量・口ぐせの枠だけ。守りの画面の文は上書きできない |
| AI の口調 | 枠から BeesBuild が決まった文を作り、「口調のデータ」として指示と分けて渡す（声） |
| 完了の演出 | 静かな光（既定）・光の粒・仲間の喜ぶ顔・1 回はねる・なし。どれも 2.0 秒まで・1 回だけ |
音だけで知らせることはしません。
置けば反映・壊れたら戻る
- 置く・保存する：人か AI が、テーマのフォルダーに書きます。
- 見張る：BeesBuild のコアが置き場を見張り、続けて書かれた変更をまとめます。
- 点検する：変わったファイルだけ点検します。
- 写す：通った物だけを写しにし、画面へ渡します。保存から 1 秒ほどで映ります（推定）。
- 確かめる：初めて当てる・AI が当てた・人からもらったテーマは、「このままにしますか？ 15 秒で元に戻ります」を出し、押されなければ戻します。
- 新しいフォルダーは一覧に札を付けて出すだけで、自動では当てません。
- 色と大きさは変数だけを差し替えるので、画面を作り直しません。声は次の読み上げから変わります。
- モードは、暗い・明るい・OS に合わせる の 3 つです。Windows のコントラストのテーマの時は、OS の色を先にします。
- 色と文字と形・仲間・声・音・文の調子・完了の演出・背景を、部分ごとに選べます。
壊れた時は 3 段で戻します。
| 段 | 戻し方 |
|---|---|
| 1 | 止める項目があるテーマは当てない。前の良い版のまま知らせる |
| 2 | 読めない絵・Rive・フォントは、その部品だけ既定に戻す |
| 3 | テーマを変えた後の起動が 2 回続けて失敗したら、次は既定で起動する |
Shift を押しながら起動するか、hb theme reset でも既定に戻せます。
点検と安全性の確認
点検は 18 の項目です。主な物を挙げます。
| 項目 | 見る物 |
|---|---|
| 型と種類 | 目次と各ファイルが決まった型どおりか。許す形のファイルだけか（.js・.css・.html・.exe などは止める） |
| 置き場 | 相対のパスだけか。ショートカットや .. は止める |
| SVG と絵 | SVG は図形だけに書き直す。絵は縦横を確かめ、撮った場所などの余計な情報を消す |
| Rive | 台本を含まない小さな版で読めるか |
| 外への参照 | どのファイルにも、外の URL やファイルへの参照が無いか |
| コントラストと色の差 | 字 4.5:1・形 3:1。色覚の 3 つの型での見分け |
| 動き | 範囲の中か・点滅が無いか |
| 文と口調 | 決まった枠だけか。「無視して」のような指示らしい言葉や URL が無いか |
| 仲間の枠とライセンス | 最小の組があるか。ライセンスとクレジットがあるか |
テーマの出どころで、確かめ方を変えます。
| 段 | 自作 | 同梱 | 人からもらった物 |
|---|---|---|---|
| 出どころ | 記録だけ | ビルドで記録 | 必須 |
| 点検（18 の項目） | 必須 | 必須 | 必須 |
| AI の読み取り | 要らない | ビルドで 1 回 | 必須 |
| サンドボックスでの試し | 要らない（プレビューで見る） | ビルドで 1 回 | 必須 |
| 人の承認 | 当てる時の 15 秒が代わり | 要らない | 必須（確認のカード） |
結果の札は、スキルと同じ 5 つ（通った・注意つき・止めた・確認中・期限切れ）です（スキル）。テーマは外へ何も送りません。
作る道具
テーマは、スキル beesbuild-theme と hb theme の命令で作ります。
- 話す：作りたい世界観を AI に話します。
- 雛形を作る：
hb theme newで、目次・tokens の写し・埋める枠の一覧を作ります。 - 書く：AI が tokens・仲間・声・文を書きます。
- 点検する：
hb theme checkの結果（JSON）を見て、AI が直します。 - 見る：
hb theme previewで、代表の 8 画面を当てずに見ます。 - 当てる：
hb theme applyで当て、人が「このまま」を押して決めます。
| 命令 | すること |
|---|---|
hb theme new | 雛形を作る。ハイブのブランドや DTCG のファイルから作ることもできる |
hb theme check | 点検する。--fix-safe で機械が直してよい物だけ直し、--fix-contrast で足りない色の案を出す |
hb theme preview | 代表の 8 画面（コントロールセンター・地図・人の番・確認のカード ほか）を、窓か PNG で見る |
hb theme apply | 当てる（15 秒の「このまま？」） |
hb theme list・schema・reset | 一覧・型の決まりを出す・既定に戻す |
終了の番号は、0 通った・1 注意つき・2 止めた・3 読めない・4 指定の誤り・5 当てたが戻った です（hb の命令）。
- 点検は BeesBuild のコアだけがします。Claude Code・Codex・BeesAgent のどれで作っても、結果が同じになるためです。
- スキル
beesbuild-themeは、手順・型・見本だけで、台本（scripts）を入れません。 - プレビューの画像の中の文字は、指示として扱いません。
- 共有と配布（
.bbthemeの包み・チームの棚）は後で作ります。実在の人の顔と声、他社のキャラクターとロゴは、配布では止めます。ベータ版の後
遊びのモード
遊びのモードは、管理の数字はそのままに、Rive で体験に包んで見せる自分用の画面です。すぐに管理の画面へ戻れます。人どうしを比べず、数を盛らず、罰やくじの動きは使いません。
同じ数の対応（区画・エージェント・人・PR・CI）を、そのまま共有のボードの型に写して出すこともできます（共有のボード）。
データの形
| 型 | 中身 |
|---|---|
HbTheme | テーマの包み（id・名前・版・元・信頼の段・借りる元・モード・部分・ファイルと sha256） |
HbThemeCheck | 点検の結果（5 段・18 の項目・直し方・コントラストの表） |
HbThemeSelection | 選んだテーマ（モード・部分ごとの選択・前の良い版・15 秒の確認） |
HbCharacterSlot | 仲間の枠（役・状態・表情・口の形・大きさ → 絵と、代わりに使った元） |
HbTonePreset | 文の調子の枠と世界観の文 |
HbCelebrationPreset | 完了の演出の型 |
HbRiveAsset | Rive の約束（絵の台・状態の機械・ビューモデル） |