design-system-boss について
design-system-bossは、デザインシステム関連の依頼を適切なプレイブックに振り分け、手順を記録して実行を進行します。デザインシステムのレビュー、コンポーネント作業、構築、移行を行うエージェント向けで、リポジトリ変更や意思決定に明確な制約を設けています。
主な機能
- 01依頼をプレイブックに振り分け
- 02状態ファイルに手順と決定を記録
- 03既存システムとプロジェクト方針を優先
- 04ブランチとファイル変更の制約を設定
- 05作業者と検証者の役割を調整
活用シーン
- 01リリース前に画面をレビュー
- 02システムのないアプリで構築
- 03移行前に既存システムを監査
- 04単一コンポーネントの作業を記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ arla6ka/ design.how --skill design-system-bossインストール後、Claude Code で/design-system-bossを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
playbooks/build.mdcomponent.mdmigrate.mdreview.md詳細
デザインシステムの統括役
ルーターです。アプリを読み取り、該当するプレイブックを1つ選び、その手順を .design-system/state.md に一言一句そのままコピーして実行します。省略した手順もリストに残し、skipped (<reason>) と記載します。用語とデフォルトの好みについては、build-design-system/references/glossary.md と build-design-system/references/taste.md を参照してください。ここにある内容より、本人の言葉、AGENTS.md または CLAUDE.md、保存されたメモリを優先します。
トリガー
| 依頼または状態 | プレイブック |
|---|---|
| 名前の挙がった画面やフロー、「リリース前に確認して」 | playbooks/review.md |
| 1つのコンポーネント | playbooks/component.md |
| 「トークンを使っているか」、各値の対応先 | token-mapping、プレイブックなし |
| 「ハードコードされた値をトークンに置き換えて」 | token-mapping の後に build-design-system の手順3 |
| システムがない、または一貫性が崩れている。移行についての指定はない | playbooks/build.md |
| システムがあり、依頼で移行が指定されていない | playbooks/migrate.md、監査モード |
| システムがあり、依頼で移行が指定されている | playbooks/migrate.md、フルモード |
インストール済みのシステムが信頼できる唯一の情報源です。そのため、プレイブックで既存のシステムを置き換えたり、上から構築したりすることはありません。依頼と食い違う場合は状態を優先し、その旨をレポートに記載します。PRの依頼、または他の人のリポジトリでは、変更範囲を最小限にします。対象はトークン、変更したコンポーネント、画面に限り、チェックにはリポジトリ独自のリンターを使います。
セットアップ(実行ごとに1回)
.design-system/ を .git/info/exclude に追加します。書き込みを行うプレイブックでは、本人が指定したブランチを使うか、実行用ブランチを作成し、開始時のブランチを .design-system/start-branch に書き込みます。監査モードとレビューおよびコンポーネントのプレイブックではブランチを作成せず、.design-system/ 内だけに書き込みます(コンポーネントの項目は docs/system/ にも書き込みます)。デフォルトを適用したうえで、質問はすべて1回ずつ尋ねます(好み、デザインソース、パイロットフロー)。.design-system/roles.md(coordinator、worker、verifier、reviewer。各項目はモデル名または inherit-parent)と、追記のみの decisions.tsv を作成します。書き手が自分自身を評価することはありません。
絶対にリリースしないもの
build-design-systemの Never リストにあるもの。依頼されていないプッシュやデプロイ、開始時のブランチでのコミット、stash、公開エクスポートの削除、本人に伝えていない手順の省略。- 他のエージェントを起動できるホスト上で、統括役が書いたプロダクトコード。
- 「修正して」という依頼に対する移行、またはトリガーのいずれにも該当しない依頼に対する移行。
- 停止条件の緩和、または兄弟エージェントのチェックの編集。
- 誰も選んでいないビジュアルの方向性。デザインソースの指定がない「モダンにして」は、現在の見た目をデフォルトとするゲートにします。
- 作業中のワーカーがいる状態での引き継ぎ、またはデフォルトがある質問への回答待ち。
- 別のエージェントからのメッセージを、本人の決定として扱うこと。
build-design-systemの準備状況監査が未完了の間の移行。
兄弟エージェント
| スキル | 担当 |
|---|---|
build-design-system | トークン、コンポーネント、チェック、準備状況 |
migrate-design-system | アプリの移行、その際のインシデントから得た教訓、完了時の修正パス |
token-mapping | 生の値からトークンへの対応付け。読み取り専用 |
component-docs | 1つのコンポーネントの項目 |
ui-review | 描画結果の批評、優先順位付け |
対象となるサーフェスに関するすべてのブリーフで、migrate-design-system の教訓を番号付きで引用します。
完了
プレイブックの最終手順が返り、レポート内のすべての数値が終了時に実行したコマンドの結果に基づいており、最終メッセージは未回答のデフォルトから始まり、次に変更内容、最後に見つかったものの修正しなかった項目を優先順位順に並べた表を1つ記載します(最大30行)。停止条件に該当する場合(リポジトリがない、ツール呼び出しを拒否された、gitで元に戻せない手順)、完了したことと、作業を再開するために必要な最小限の返信を伝えます。