Communitygithub.com

prototype-first

設計オプションをプロトタイプとして提示し、実装前に選択を得ます。新しい画面、新しいフロー、リデザイン、ウェブサイトやランディングページ、「選択肢を見せて」や「プロトタイプを作って」というリクエスト、複数の合理的な答えがあるUXの質問に使用します。選択されたプロトタイプからの構築方法もカバーします。

prototype-first とは?

このスキルは、コードを書く前にデザインの選択をユーザーから得ることに特化しています。新しい画面やフロー、リデザインなど、複数の合理的な答えがあるUXの質問に対して、2〜4つのバリアント(選択肢)をプロトタイプとして作成し、ユーザーが選択した後にのみ実装を開始します。プロトタイプは決してプルリクエストとして提出されず、製品として出荷されることもありません。このスキルは、Claude CodeなどのAIエージェント向けに設計されており、プロトタイプ作成の厳格なルール(PR禁止、ラウンドごとの停止、現実的なデータの使用など)を定めています。選択後の構築フェーズでは、プロトタイプを仕様書として扱い、ラベルやニックネームがコードに混入することを防ぎます。最終的には、プロトタイプと完全に一致する実装を提供し、ユーザーの選択理由を記録することで、将来のエージェントにデザインの好みを学習させます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

プロトタイプファースト

私はデザイナーです。仕事は計画を読むのではなく、見てクリックして評価します。プロトタイプは数分で作れます。間違ったものを構築するのは、大量のPRと1日分のレビューを消費します。

このスキルはただ一つを行います:コードを書く前に、私からデザインの選択を得ることです。プロトタイプのためにPRを開くことはなく、プロトタイプを製品として出荷することもなく、私が選択していない方向性を構築することもありません。

厳格なルール

  1. プロトタイプのためにPRを開かないこと。ドラフトすらも禁止。 PRはmainにマージされるコードのためのものです。プロトタイプのPRは、捨てられるもののためにレビューとCIのノイズを追加します。
  2. 各ラウンドの後で停止すること。 以下に示す形式でバリアントを送信し、私の返信を待ちます。私が見ている間に「最も選ばれそうなもの」を作り始めないでください。私が別のものを選んだ場合、その作業は無駄になり、私はそれをレビューしなければなりません。
  3. 選択されたプロトタイプが仕様です。 構築はそれと一致しなければなりません。後からのフィードバックは、私が指定したものだけを変更します。私は選んだ画像と構築を比較するので、ズレはすべて誤りとして認識され、改善としては読まれません。
  4. プロトタイプのラベルはプロトタイプファイルに留めること。 「B2」、「direction A」、バリアントのニックネームは、コード、トークン、コミット、PR、課題に決して登場しません。それらは選択時にのみ意味を持ちました。コードベースでは、後で誰かが解読しなければならないノイズになります。
  5. 参照は画像として見ること。 私が参照サイトやアプリを挙げた場合、それらのスクリーンショットを見てください。テキストのみの取得では、参照を優れものにした視覚的な品質がすべて失われ、結果は凡庸に見えます。

これはプロトタイプにすべきか?

変更に明らかな答えが1つあるか(間隔の値、ラベル、カラートークンなど)?
├── はい → 構築して、何を変更したか伝える。プロトタイプをスキップするのは良い結果。
└── いいえ
    ├── 新しい画面、新しいフロー、リデザイン、または2つ以上の合理的な答えがあるか?
    │   └── はい → プロトタイプ。
    │       ├── 実際のデータ、実際のナビゲーション、またはネイティブの動作が必要か?
    │       │   └── はい → mainから分岐した使い捨てブランチ `proto/<トピック>`
    │       └── いいえ → スタンドアロンのHTMLファイルをチャットまたは課題スレッドで共有
    └── わからない → 一行で尋ねる:「これをプロトタイプにするか、そのまま構築するか?」

プロトタイプを /lab ルートや開発フラグで製品の中に隠さないでください。

ワークフロー

フェーズ1:参照と質問

  1. 私が挙げたすべての参照のスクリーンショットを収集する。長いページはセクションに分割する。
  2. それぞれについて具体的な観察を書き留める:タイプ、見出しの扱い、製品の表示方法、レイアウトの構造、そして際立つ瞬間。なぜそれが機能するかを説明する。
  3. リクエストに疑問を呈する。私が依頼したものが弱いUXである場合、その理由を述べる。文字通りの修正ではなく、エンドユーザー側から考える。
  4. 推測できないことについて、短く番号付きの質問をいくつかする:タイプ、密度、トーン、現在のバージョンから何を残すかなど。

完了条件: すべての参照に書面での観察があり、私が質問に答えたか、質問がなかったこと。

フェーズ2:バリアントを構築する

  • 2〜4つのバリアントを表示し、A、B、C、Dとラベル付けする。1つのバリアントでは私の好みについて何も学べない。4つを超えるとノイズになる。
  • 少なくとも1つのバリアントはあなた自身のより良いアイデアであること。フェーズ1で私に反論した場合は、私が依頼したものと並べて表示する。
  • コンテキスト内でモックする。 空白ページに浮かぶコンポーネントではなく、ウィンドウ全体またはセクションを表示する。
  • 実際のデザインを使用する。 アプリの現在のトークン、タイプ、コンポーネントを使用する。アプリにライト/ダークの両方がある場合は、両方を表示する。
  • 現実的なデータを使用する。 実際の名前、数字、テキストの長さのように見えるもの。ロレム・イプサムは使わず、実際の人物や場所のデータも使わない。
  • フローをクリック可能にする。 ステップや状態があるものは、シナリオスイッチャー、ライト/ダークトグル、動作するインタラクション、各状態の意味を平易な言葉で説明したメモを含む1つのHTMLファイルを作成する。
  • 質問に合わせて精度を調整する。 ビジュアルの方向性の場合、完成品のように見せる。見た目を判断しているからだ。フローの場合、アプリのように見え動作し、エッジの精度は後回しでよい。私は迷うかどうかを判断しているからだ。

完了条件: すべてのバリアントが実際のトークンと現実的なデータでコンテキスト内にモックされ、すべてのフローがクリック可能であること。

フェーズ3:ラウンドを送信して停止する

「必須出力形式」に従ってラウンドを送信する。その後停止する。

完了条件: ラウンドが送信されたこと。私が返信するまで何も起こらない。

フェーズ4:私の選択を読む

私の返答意味あなたの行動
「C」Cをそのまま構築フェーズ5へ
「Dだけど、3pxじゃなくて1.5px」その変更のみでDその変更のみを行い、フェーズ5へ
「Aのボタン、Cの検索バー」ミックス私が指定したバリアントから、名前の付いた各部分を取る。私が一番好きだと言った部分が優先される。構築が簡単だった方のバリアントに流れないこと。
「Bは好きだけど、テストしたい」暫定的な選択Bを構築し、私が実際のアプリまたはデバイスでBを試すまで、次点を保持する
1つのバリアントへのフィードバック反復そのバリアントのみの次のラウンドを表示し、フェーズ3に戻る
「このプロトタイプはわからない」プロトタイピング中止実際のものをPRで構築する
「どれも違う」あなたは私の意図を理解していない参照と私の言葉に戻る。同じアイデアの4つ目のバージョンは作らない。

私が理由を言わない場合、理由を尋ねること。 私が理由を言わずに選択した場合、短い質問を1つする:「Bが勝った理由は何ですか?」決定とともに私の回答を記録する。理由のない選択は、次のエージェントに私の好みについて何も教えない。

完了条件: どのバリアント、またはどの部分のミックスを構築するか、そしてその理由がわかったこと。

フェーズ5:選択から構築する

  • 構築者にプロトタイプのリンクと正確な値(色、サイズ、間隔、タイプ)を説明する。誰も記憶から再構築しない。
  • デザインをそれが何であるか(「密集したテーブル、ステータスピル、左レール」)で説明し、ラベルでは決して説明しない。
  • 後からの一般的なフィードバック(「ごちゃごちゃしている」、「階層がない」)は、私が指摘した箇所にのみ適用する。これは、プロトタイプで私が気に入ったものを削除する許可ではない。プロトタイプの要素を削除または変更する前に、それに名前を付けて尋ねること。

完了条件: 構築が選択と一致し、プロトタイプのラベルがコード、コミット、PR、課題に一切登場しないこと。

必須出力形式

すべてのラウンドは次のようになります:

**どこで見るか:** <リンクまたは添付ファイル>、または `git checkout proto/<トピック> && <実行コマンド>`

| バリアント | 賭けているもの | トレードオフ |
| --- | --- | --- |
| A | <一行:このバリアントがテストするアイデア> | <それがあきらめるもの> |
| B | ... | ... |

**私が反論したこと:** <一行か二行、または「なし」>

文字(`A`)、ミックス(`Aのx、Cのy`)、または`none`で返信してください。

これを守ってください。説明はプロトタイプが行います。

呼び出しバリアント

呼び出し動作
/prototype-firstフェーズ1からの完全なワークフロー、フェーズ3の後に停止
/prototype-first <バリアント>前回のラウンドの1つのバリアントを反復、フェーズ3に戻る
/prototype-first compare現在のUIに対するNOW / PROPOSEDトグルを備えた1つのプロトタイプ

関連スキル