Communitygithub.com

21 Grams UX

AIが構築したプロダクトのフローとユーザビリティを監査・修正し、人が期待する通りに動作するようにします。プロジェクトの既存コンポーネントとパターンをそのまま使用します。

21 Grams UX とは?

21 Grams UXは、AIによって構築されたプロダクトのユーザビリティを監査・修正するためのスキルです。UIキットを追加したり、プロダクトを再設計したりするのではなく、プロジェクトが既に持っているコンポーネントとパターンを使って、デッドエンド、状態の欠落、サイレント障害、回復不能な操作など、人間が実際に使う際に問題となる箇所を修正します。主にClaude CodeなどのAIエージェント向けに設計されており、ユーザーが「21 Grams UX」を依頼した時や、特定のフローや画面のユーザビリティ監査を依頼した時に使用されます。このスキルは、ナビゲーション、フォーム、状態管理、フィードバック、オンボーディング、アクセシビリティなど、9つの領域にわたる詳細なルールと、業界をリードする製品のリサーチに基づいたフィールドルールを提供します。作業フローは、まずプロジェクトのインベントリを取得し、リサーチ、フローのマッピング、ブラウザでの実地確認、監査の実施、修正の適用、検証、レポート作成というステップで構成されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ilbognov/21grams/tree/main/skills/ux

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

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

ドキュメント

21 Grams UX は何をしますか?

既存のフローを監査し、修正します。21 Grams UX(21 GramsファミリーのUXパッケージ)は、プロダクトを再設計したり、UIキットを追加したりしません。実際のフローを辿り、AIが構築したプロダクトが利用者にとってどこで問題を引き起こすか(デッドエンド、状態の欠落、サイレント障害、回復不能な操作、ユーザーと戦うフォームなど)を特定し、プロジェクトが既に持っているコンポーネントとパターンを使って修正します。

21 Grams UIは見た目を担当します。21 Grams UXはそれが機能するかどうかを担当します。両方がインストールされている場合は、先にUXを実行してください。存在すべきではないステップを磨き上げる意味はありません。

ルールゼロ:プロジェクト独自のコンポーネントを使用する

すべての変更は、プロジェクトが既に使用しているものを通じて行われます。21 Grams UXは、並列のコンポーネントセットや並列フローを決して構築しません。

  1. 何かに手を触れる前にインベントリを取ること。 ルーターとルートマップ、コンポーネントライブラリ、フォームライブラリとバリデーションアプローチ、トースト、ダイアログ、空状態コンポーネント、データフェッチレイヤー(ローディング状態とエラー状態の発生源)、およびアナリティクスまたはイベントレイヤー(存在する場合)を確認します。
  2. 問題が存在する場所で修正すること。 欠落したエラー状態は、個々の画面ではなく、共有のデータコンポーネントまたは空状態コンポーネントに追加します。確認パターンは、一回限りのものではなく、プロジェクトのダイアログに追加します。
  3. その役割を果たすコンポーネントや依存関係が既に存在する場合、新しいものを追加しないこと。 21 Grams UXの効果を得るために、新しいフォームライブラリ、トーストライブラリ、ツアーライブラリを追加しないでください。
  4. 要素が本当に欠落している場合(空状態コンポーネントがない、元に戻す機能がないなど)、プロジェクトの既存のプリミティブから、そのファイルレイアウトと命名規則に従って構築します。その旨をレポートに記載します。
  5. プロダクト上の決定はプロダクトのものです。 21 Grams UXは、プロダクトの内容、対象ユーザー、ビジネスルールを変更しません。既存のタスクの実行方法を変更するだけです。スコープを変更するものはすべて、修正としてではなく、レポート内の質問として記載します。

優先順位: ユーザーの言葉、次にプロジェクトの確立されたパターンとプロダクトルール、最後に21 Grams UXのハウスルール。

内部構成

  1. UXリサーチステップ。 フローを設計または再設計する前に、現在のプロダクトと3~5つの業界をリードする例を、Mobbinのようなパターンライブラリが接続されている場合はそれを使用して、一度に1つずつ分析します。完全なプロセスは references/research.md にあります。
  2. UXの法則。 ルールの基盤となる知識。references/laws.md にあり、セクションごとにA1、A2…として引用されます。セクションAは中核となる法則です:ヒックの法則、フィッツの法則、ヤコブの法則、ミラーの法則、ドハティの閾値、テスラーの法則、ポステルの法則。どのルールも該当しない場合、法則から推論します。
  3. UXルール。 references/rules.md に番号付きで記載されたルール。各ルールには、ルールの内容、適用方法、フラグを立てるべき点、およびクイック監査チェックリストが含まれます。モバイルファーストで記述され、ウェブにも適用されます(「ボトムタブ」のプライマリナビ、「ボトムシート」のポップオーバー)。
  4. フィールドルール。 AI構築プロダクトに関する実際のレビューセッションと、主要プロダクトに関するUXリサーチから学んだルール。references/field-rules.md にあり、F1、F2…として引用されます。このファイルはセッションのたびに成長します(「フィールドルールの拡充」を参照)。
  5. エリア別ハウスルール。 rules/ 内にあり、エリアごとに1ファイル。各ファイルには、そのエリアに属する法則、番号付きルール、フィールドルールがリストされています。
ファイルエリア
navigation.mdナビゲーションと道案内
forms.mdフォームと入力
states.md空、ローディング、エラー、成功状態
feedback.mdフィードバックとシステム状態
onboarding.mdオンボーディングと初回実行
destructive.md破壊的操作と復旧
accessibility.mdアクセシビリティとキーボード
flows.mdフローとタスクの長さ
choice.md選択と認知負荷

ルール#1~5は予約されており、後のバージョンで追加されます。エリアにルールができるまでは、一般的なユーザビリティ判断で監査し、その旨をレポートに記載します。

非交渉事項

  • Xはモーダルまたはフローを閉じます。左矢印は1つ前の画面に戻ります。(#6)
  • ローディング中は空白画面にしない:スケルトン、スピナー、またはプログレスバーを使用します。(#7)
  • フィードに戻るときは、スクロール位置を正確に復元します。(#8)
  • アクティブなタブをタップすると、トップに戻ります。(#9)
  • ユーザーが画面の最下部に到達する前に、次のページを読み込みます。(#10)
  • いいね、フォロー、保存は楽観的に実行し、失敗時にはロールバックとメッセージを表示します。(#11)
  • 下書きと未完了の入力は自動的に保存します。(#12)
  • パーミッションは、機能が使用される時に要求し、起動時には決して要求しません。(#13)
  • クイックアクションは、スワイプダウンで閉じることができるボトムシートで開きます。(#14)
  • 通知と共有リンクは、正確なコンテンツを開きます。(#15)
  • ステップごとの選択肢は少なく、推奨されるデフォルトを設定し、残りは開示します。(A1)
  • プライマリアクションは大きく、手の届く範囲に配置し、タッチターゲットは44×44ピクセルにします。(A2)
  • 一般的なジョブには標準パターンを使用します。(A3)
  • 情報はグループ化し、ステップ間で何かを記憶する必要がないようにします。(A4)
  • すべての入力はすぐに確認応答し、長い待機時間がある場合は進捗を表示します。(A5)
  • プロダクトが複雑さを負担し、ユーザーには負担させません。(A6)
  • 乱雑な入力を受け入れ、クリーンにしてエコーバックしますが、セキュリティやデータ整合性を緩めてはいけません。(A7)
  • ジョブごとに1つのコントロール。(F1)
  • 画面のアクションは右上にグループ化し、プライマリは隅に配置し、セレクターと混在させない。(F2)
  • セカンダリ詳細はオンデマンドで表示し、決して失わない。それへの唯一のアクセス可能なパスを削除しない。(F3、F5)
  • 各事実は一度だけ述べる。画面上にバージョン番号、デザインノート、内部専門用語を表示しない。(F6、F9)
  • インタラクションが変わるときは、それを説明するすべてのヒントも変更する。(F8)
  • 新しいUIは、プロダクトが宣言したスコープを超えて主張しない。(F10)
  • それを開いた選択を繰り返すステップは設けない。1つのオプションがあるなら、それを実行するだけにする。(F13、F17)
  • 1つの選択に対して1つのコンテキストツールバーを表示し、クリックアウェイで消える。(F16)
  • 追加できるものはすべて削除でき、削除時には何が削除されるかを表示する。(F18、F19)
  • ショートカットはツールチップに表示し、ブラウザ予約のキーは使用しない。(F20)
  • AI提案は暫定的に見え、1つの承認/拒否パターンを使用し、承認は即座に行う。(F23)
  • オンボーディング:2つの等しい入口、画面ごとに1つの質問と進捗表示、アカウント作成前に価値を示し、スキップ可能なツアー。(F28、F29、F32、F36)
  • お金に関しては正直に:実際の無料パス、日付付きのトライアル、制限に達した時のアップグレード。(F35)
  • 読み取りと選択は、狭い中央揃えのカラムで行う。ステップのコンテキストとアクションのみを固定する。(F37、F38)
  • 欠落データはN/Aと表示し、テキストは切り詰めて整列させ、すべてのリストは実際のボリュームで確認する。(F43、F44、F45)
  • ロールはアプリの開始点を変更するものであり、アプリそのものを変更するものではない。モバイルとデスクトップは同じパターンを共有する。(F47、F50)

ワークフロー

  1. インベントリを取る(ルールゼロ)。
  2. リサーチする(references/research.md)。新しいフロー、再設計、またはオンボーディングの場合は、ここから始めます:何が誰のために設計されているかを調べ、現在のフローを分析し、3~5つの業界をリードする例を推奨し、変更を加える前にユーザーと一緒にそれらを一つずつ確認します。既存のフローの小さな修正のみの場合に限り、このステップをスキップします。
  3. フローをマッピングする。 ユーザーが行う主要なタスクをリストアップし、それぞれについてプロダクトを通るルート(エントリーポイント、すべてのステップ、すべての分岐、終了状態)を記述します。各ステップのデータの出所をメモします。
  4. ブラウザで各フローを実際に確認する。 コードだけでなく。ハッピーパスを試した後、エッジケース(何もない状態、低速ネットワーク、失敗したリクエスト、無効な入力、戻る操作、フロー途中でのリフレッシュ、キーボードのみ、狭い画面)を試します。
  5. 何かを変更する前に監査する。 references/rules.md、references/laws.md、references/field-rules.md の最後にあるチェックリストと、エリアファイルを確認します。調査結果をエリア、ルール番号、法則別にグループ化してリストアップします。各調査結果には、フローとステップ、ファイルと行番号、ユーザーにとっての問題点、修正方法、および修正がどの既存のコンポーネントまたはパターンに入るかを含めます。優先度を付けます:タスクをブロックする、タスクを遅くする、荒い部分。
  6. 監査結果を簡潔なリストとしてユーザーに表示し、広範な変更を適用する前に尋ねます。要求されたスコープ内の小さな明白な修正は、直接適用できます。
  7. 修正を次の順序で適用します: 共有コンポーネントとパターン → フロー → 個々の画面。差分はスコープを限定し、プロジェクト独自の規則に従ってください。
  8. ブラウザでフローをもう一度確認して検証します。 ステップ3のエッジケースを含みます。変更された各ステップのビフォーアフターをキャプチャします。
  9. レポートを作成します。 フローとエリアごとに何が変更されたか、どのコンポーネントが触れられたか、およびプロダクト上の決定である未解決の質問を報告します。

フィールドルールの拡充

21 Grams UXは実際の作業から学びます。作成者がAI構築プロダクトに関するレビューセッションを終了し、その追加を依頼した場合:

  1. そのセッションの会話を読み、作成者が依頼または承認したすべての変更をリストアップします。
  2. UXの変更(フロー、構造、配置、状態、フィードバック、ユーザーを導くコピー、アクセシビリティパス)を保持します。視覚的な変更(半径、色、タイポグラフィ、アイコン、モーション)は21 Grams UIに属します。
  3. それぞれを一般的なルールとして記述します:ルールの内容、プロジェクト独自のコンポーネントを通じて適用する方法、フラグを立てるべき点。クライアント名、プロダクト名、機密情報は含めません。
  4. ルールが既存のルールを洗練するものである場合、新しいルールを追加する代わりに既存のルールを更新します。
  5. 新しいルールを references/field-rules.md のセッション見出しの下に追加し、F番号を続け、適切なエリアファイルにリストアップします。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル