design-system-boss について
design-system-bossは、リポジトリでのデザインシステム作業を計画・追跡する調整スキルです。状況に応じて関連スキルへ作業を振り分け、証拠を確認して引き継ぎレポートを作成します。
主な機能
- 01リポジトリの状況と意図から経路を選択
- 02関連するデザインシステムスキルを調整
- 03状態ファイルで手順と判定を追跡
- 04証拠とクリーンクローンの結果を確認
- 05ファイルに基づく引き継ぎレポートを作成
活用シーン
- 01デザインシステム作業前のリポジトリ整理
- 02デザインシステムの構築やレビューの調整
- 03移行の許可と未解決事項の追跡
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ arla6ka/ skills --skill design-system-bossインストール後、Claude Code で/design-system-bossを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdTESTS.mdreferences/coordinator-path.mddelegation.mdroutes.mdstate.mdtriage.mdscripts/triage.sh詳細
デザインシステムの責任者
.design-system/boss/state.mdが存在する場合は、そこから再開します(references/state.md、「再開」)。存在しない場合は、scripts/triage.shを実行します(references/triage.md)。- シグナルから状態、意図、基盤を選びます(
references/triage.md)。small_app yesの場合は、ファストパスを選びます(references/routes.md、「小規模アプリ」)。 - 下の表からルートを選びます。依頼でマイグレーションが指定されていない限り、チェック優先で終わります(
references/routes.md、冒頭のルール)。 - 実行ブランチを選び、フェーズの上限を設定し、ホストを調査して、状態ファイルを書き込みます(
references/coordinator-path.md、手順 6~9)。 - すべてのデフォルトを適用した状態で Frame を送ります。質問に回答がなければ、デフォルトを
default (unanswered)として維持し、実行を続けます(references/triage.md、「唯一の質問」)。 - サブエージェントを通じてルートの手順を実行します。一度に書き込みを行う手順は 1 つだけです(
references/delegation.md)。決定済みのデフォルトは、ドキュメントの作成前に反映します。 - 各返却内容をファイルで確認し、判定を記録します(
references/delegation.md、「返却内容の確認」)。 - 締めくくりとして、トリアージを再実行し、クリーンクローンを確認し、キャプチャを取得してから、
close.mdと「発見したが未修正」の表を 1 つ作成します(references/state.md)。 - 最終メッセージでは「レポート」セクションを送り、未回答のデフォルトを先に記載し、マイグレーションの規模も提示します。
以下は決して出荷しないでください。
- サブエージェントを起動できるホスト上で、責任者が作成したプロダクトコード。
- 許可なく安全な変更の範囲を超えるマイグレーション。「修正して」という依頼を許可と解釈すること。
- 決定済みのデフォルトが反映される前に作成されたドキュメントまたは仕様のコミット。
- デザインソースに関する質問を通じて誰も選んでいない新しいビジュアルの方向性。
close.mdのどの行にも記載されていないレポート内の数値。- 作業者がまだ実行中の引き継ぎ。
- デフォルトがある質問への回答を待ったり、その質問を理由に停止したりした実行。
責任者がサブエージェントとして実行される場合、ワーカーはフォアグラウンド呼び出しで起動します。複数のワーカーを並行して実行する場合は、1 つのメッセージ内で複数呼び出しを行います。バックグラウンドのワーカーを実行したままターンを終了することはありません。実行中のワーカーを放置すると、誰も確認しないリポジトリへの書き込みが続きます。
作業を担うのは、兄弟となる 5 つのエージェント、build-design-system、migrate-design-system、token-mapping、ui-review、component-docs です。それぞれの「コーディネーターから呼び出された場合」セクションを通じて呼び出します。兄弟エージェントのパスは <skills> を起点とします。surface、gate、clearance、ステータス用語の意味は、build-design-system/references/run-record.md(「用語」)に定められており、そこに記載された常設の指示は責任者にも適用されます。まず references/coordinator-path.md を読んでください。各手順と、開くべきファイルが記載されています。
出力
完了とは、ルートの最後の手順が返却され、すべての手順のステータスと判定が .design-system/boss/state.md に記録され、レポートがファイルに基づいて作成されている状態です。以下で確認できます。
triage/signals.tsvとtriage/after/signals.tsvがscripts/triage.shから生成されており、ルートがルーティング表どおりであること。異なる場合は、その理由を判断行に記載すること。- すべての手順に、根拠となるファイル名を含む判定があること。レポート内のすべての数値が、単位と出典を含めて
close.mdの行に記載されていること。 - すべての兄弟エージェントの記録にあるすべてのゲートが、状態ファイルの Gates 表に記載されていること(
references/state.md、「状態ファイル」)。未回答の項目はすべてdefault (unanswered)と記載されていること。 - 書き込みを伴うルートでは、実行ブランチのクリーンクローン上でチェックが終了コード 0 を返すか、リポジトリ独自のリンター、型チェック、ビルドが最小限の実行環境で成功すること。変更されたすべての surface にキャプチャとモンタージュの行があり、値が同一の置き換えにはそれぞれ根拠があり、すべてのパイロット上の問題が数値で修正されるか、測定を条件に保留されていること。変更前後の
git statusが保存され、.design-system/tmp/が削除され、追跡されていないパスがすべてコミットされているか、判断行に記載されていること。 - レポートの末尾に「発見したが未修正」の表が 1 つあり、重要度順で最大 30 行であること。
最終チャットメッセージには、状態ファイルの「レポート」セクションをそのまま記載します(references/state.md、「引き継ぎレポート」)。以下の停止条件に該当する場合は、該当する条件、完了した作業、状態ファイルのパス、作業を再開するために必要な最小限の返信を返してください。例:「どのアプリか教えてください:apps/web または apps/admin」。
入力
| 入力 | ない場合 |
|---|---|
| 依頼内容 | 必須です。「UI がめちゃくちゃです」だけでも構いません |
| リポジトリ | ない場合は停止します。読み取り専用アクセスでは、Audit と Review のみ実行できます |
| モノレポ内の対象アプリ | 1 つ質問します。デフォルトではルート数が最も多いアプリを対象にします。その間、すべてのアプリをトリアージします |
| 意図 | references/triage.md に従い、依頼内容の表現から判断します |
| 予算 | Frame の Go, <budget> という返信を優先し、なければホストのセッション、どちらもなければ 2 時間です。references/routes.md(Budget)に従って配分します |
| 関連するスキル | <skills> 内にあるものです。不足している場合、そのスキルの手順のみを停止し、レポートに記載します |
| サブエージェント、ブラウザー、シェル | references/delegation.md に従って調査します |
AGENTS.md または CLAUDE.md、依頼者の言葉、保存されたメモリ | これらは、すべてのスキルのデフォルト設定より優先されます。ブランチとプッシュのポリシーも例外ではありません。「現在のブランチで作業してください」とあれば、それを実行ブランチとします。すべてのブリーフに反映してください |
マイグレーションの許可を得る
マイグレーションについて明記された依頼、または引き継ぎ時の提案への返信(build-design-system/references/run-record.md の Terms)によって、許可が得られます。フォールバックの意図や「直してください」のような不満の表明は、許可とは見なされません。許可がある場合は、Audit の plan.md を再度ピン留めし、ビルドの registry.json と整合させたうえでのみ編集をマイグレーションします。また、マイグレーションのローリングウィンドウは、マシンの予算内で互いに重複しないパスに対して実行します。許可がない場合、ルートは check-first で終了します。実行途中の依頼については、references/routes.md(冒頭のルール)に従います。
ルーティングテーブル
State、weak、Intent は references/triage.md に従います。各ルートの手順は references/routes.md にあります。手順を一字一句そのままコピーし、省略した手順も skipped (<reason>) として記載します。
| State | Intent | Route |
|---|---|---|
| installed | review | インストール済みシステムの SKILL.md を基準に Review を実行します。以下のすべての行より優先されます |
| installed | audit | インストール済みシステムを対象に Audit を実行します |
| installed | その他 | インストール済みシステム |
| system repo | review、audit、component | 以下の該当する Intent の行 |
| system repo | その他 | System repo |
| empty | 任意 | Seed |
| none、または weak ではない drifting | build | Build |
| drifting、weak | build | Frame に明記された Harden |
| 任意、依頼に PR または upstream がある場合 | named families | Named families、最小限のフットプリント。以下のすべての行より優先されます |
| drifting または settled、weak | full、harden、adopt | Harden の後、step 5 から Full を実行します。values の Intent の場合は先に Values を実行します。後続のすべての行より優先されます |
| none、drifting または settled、weak ではない | harden | Harden。harden_dirs がない場合は Build |
| none または drifting、weak ではない | full | Full |
| settled または documented、weak ではない | full、adopt | Adopt |
| drifting、weak ではない | values | Values |
| settled | docs | Document |
| 任意 | component | Component |
| 任意 | review | Review |
| 任意 | audit | Audit |
インストール済みシステムが信頼できる情報源であるため、その上から別のルートで Seed、Build、Harden を実行することはありません。システムは、所有者向けに記録されたギャップによってのみ拡張されます(references/triage.md の The installed system)。依頼に PR または upstream が含まれる場合、またはリポジトリが他者のものと思われる場合、ルートは <route>, minimal footprint として実行します(run-record の Terms にある Footprint)。依頼内容と State が食い違う場合は State を優先し、その旨を Frame に記載します。State が none のときの「マイグレーションしてください」は Build です。
境界
ルート、実行ブランチ、フェーズ分割、並行して実行する読み取り専用の手順、失敗した手順の再試行(1回)、依頼で指定されていない兄弟入力のデフォルト、出力が最新の手順をその記録を引用してスキップするかどうかを決定できます。
デフォルトを適用したうえで確認し、続行します。
- 書き込みを行うルートで、チェックアウトに未コミットの変更がある場合、または他の人のブランチを使用している場合。デフォルト:HEAD から専用のワークツリーに実行ブランチを作成し、チェックアウトは見つかった状態のままにします。stash は決して使用しません。
- 書き込みを行うルートで、読み取り専用アクセスを求められた場合。デフォルト:Audit。
リポジトリがない場合、または兄弟が停止用の形式を返し、次の手順でその出力が必要な場合に限り、停止します。
兄弟の述語を決して緩めたり、兄弟スキルを編集したりしないでください。デザインの参照元がない「今風にして」という依頼は、デフォルトの「現在の見た目を維持する」(references/triage.md、Standing questions)を適用するゲートになります。