使い方ガイドへスキップ
plan-design-review作者 Garry Tan

Plan Design Review スキル。

Claude Code と Codex のデザインレビュー向けスキル:実装前にデザイン計画の完全性と体験上のリスクをレビューします。

  • デザインレビュー & アクセシビリティ
  • レビューレポート
garrytan/gstack · plan-design-review/SKILL.mdSKILL.md
--- name: plan-design-review description: Designer's eye plan review — interactive, like CEO and Eng review. (gstack) --- ## When to invoke this skill ## Confusion Protocol ## Claimed Limitations Need Evidence ## Continuous Checkpoint Mode ## Context Health (soft directive) ## Question Tuning (skip entirely if QUESTION_TUNING: false)
アップストリームファイルから読み取ったフロントマターとセクション見出し(2026-09-14)· 全72,139文字

01 できること

Claude Code と Codex における plan-design-review Skill の動作内容

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

実装に入る前に、デザインプランの網羅性と体験上のリスクをレビューします。7つのデザインパス(情報アーキテクチャ、インタラクション状態、ユーザージャーニー、空状態、視覚的階層、AI Slop リスク、アクセシビリティ)を実行し、それぞれを0〜10で評価し、10点になるには何が必要かを説明した上で、プランを修正してその状態に近づけます。UI がスコープに含まれる場合、デフォルトで gstack デザイナーによるビジュアルモックアップを生成します。

任意で「外部の視点」ステップを含みます:Codex が OpenAI のデザインの厳格なルールとリトマステストに基づいて評価し、Claude サブエージェントが独立した網羅性レビューを実行します。プランモードで動作します。実際に公開されているサイトのビジュアル監査には、代わりに /design-review を使用してください。出力結果は、プランに関するドキュメントではなく、構造化されたレビューレポートを備えたより良いプランです。

生成されるもの

  • デザイン上のギャップが解消され、各次元が評価され、構造化された GSTACK REVIEW REPORT セクションが追加された改善版プランファイル
  • 比較ボード用の HTML ファイルと、ユーザーが選択したバリアント、評価、コメント、フィードバックを記録した approved.json
  • 外部の視点が実行された場合、Codex と Claude サブエージェントの調査結果を統合したリトマススコアカード
プロンプト例を見る ↗

仕組み

  1. 01
    スコープゲートがレビュー対象を確認します

    何よりも先に、プランモードがアクティブなプランを自動選択した場合、またはユーザーが明示的に対象を指定した場合を除き、レビュー対象(ブランチの差分、プランドキュメント、特定のページ)をユーザーに確認します。

  2. 02
    デフォルトでビジュアルモックアップを生成します

    gstack デザイナーが利用可能で、プランに UI スコープが含まれる場合、許可を求めることなく即座にモックアップを生成します。

  3. 03
    任意の外部デザインの視点が並行して実行されます

    ユーザーが選択した場合、Codex(デザインの厳格なルール+リトマステスト)と Claude サブエージェント(独立した網羅性レビュー)を同時に起動します。

  4. 04
    7つのデザインパスが0〜10で評価し、ギャップを修正します

    各次元(情報アーキテクチャ、インタラクション状態、ユーザージャーニー、空状態、視覚的階層、AI Slop リスク、アクセシビリティ)についてプランを評価し、10点満点の状態がどのようなものかを説明し、ギャップを解消するようにプランを編集し、再評価を行い、10点になるかユーザーが「次に進む」と言うまでこれを繰り返します。

  5. 05
    構造化されたレビューレポートをプランファイルに書き込みます

    実行内容・状況・調査結果の表、VERDICT 行、未解決事項のステータスを含む GSTACK REVIEW REPORT セクションを、ファイルの末尾(非空白の最終行)として追加します。

02 適合性を確認

plan-design-review スキルを使用するタイミング

この種のデザインレビューが仕事の場合、Claude Code または Codex で plan-design-review スキルを使用してください。適合性と制限は、スキル自身のファイルから取得されています。

適している場合

  • ユーザーが UI/UX コンポーネントを含むプランを作成しており、実装開始前にレビューが必要な状態です
  • デザインプランには、コーディング開始前に抽象的な説明を具体化するためのビジュアルモックアップが必要です
  • プランにはバックエンドの動作は記載されているが、ユーザーに何が表示されるか、空状態、エラー状態、レスポンシブ動作については一切指定されていません

境界を知る

  • UI スコープを含まない、純粋なバックエンド、API のみ、またはインフラ関連の変更
  • ライブサイトのビジュアル監査(代わりに /design-review を使用)

提供すべきもの

  • UIスコープを含む設計プランまたはブランチdiffプランファイル、ユーザーが貼り付けたドキュメント、特定のページ/パス、または現在のブランチdiff。
  • 比較ボードによるモックアップフィードバックgstackデザイナーはHTTP経由で比較ボードを提供し、ユーザーがバリアントを評価し、コメントを残し、Regenerate/Remixをクリックするか、最終選択を送信します。

03 スキルの内部

plan-design-reviewスキルがClaude CodeとCodexに与えるルール

SKILL.md がエージェントに設定する 5 つの具体的な指示、デフォルト、制限 — ファイルの中でも結果を左右する部分です。

  1. すべての設計成果物は ~/.gstack/projects/$SLUG/designs/ に保存されます

    モックアップ、比較ボード、approved.jsonは、必ずユーザーのgstackプロジェクトのdesignsディレクトリに保存する必要があり、.context/、docs/designs/、/tmp/、またはプロジェクトローカルの任意のディレクトリに保存してはなりません。

  2. 優先順位の階層:Step 0 > モックアップ > インタラクションステート > AIスロップ > IA > ユーザージャーニー

    デザイナーが利用可能な場合、Step 0のスコープ評価やモックアップ生成をスキップしないでください。レビュー通過前のモックアップは交渉の余地がありません。

  3. DESIGN.mdが存在する場合、デザインレビューはそれに合わせて調整されます

    DESIGN.md が存在する場合、すべてのデザイン上の決定は記載されたデザインシステムに沿っていなければなりません。

  4. Outside Voicesは事前にIssuesをPassesに読み込みます

    Codexからのハード拒否は、[HARD REJECTION]タグ付きでPass 1の最初の項目として提起されます。Litmus DISAGREE項目は、関連するパスで両方の視点を表示します。

  5. 完全性の原則:AIは完全性を安価にする

    完全なカバレッジ(テスト、エッジケース、エラーパス)を推奨します — 海を一度に沸かすのではなく、湖を一つずつ沸かします。

04 実際に使う

Claude Code または Codex に plan-design-review をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、またはあなたのエージェントに plan-design-review を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/garrytan/gstack --skill plan-design-review

plan-design-review/SKILL.md用の汎用skills CLI形式。リポジトリが独自のパスを文書化している場合もあります。

スキルに最初のデザインレビュータスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Review the design plan in [plan-file-path] before we start building. The plan describes a new onboarding flow with three screens, email capture, and a welcome modal. I want to make sure we're not missing interaction states, empty states, or accessibility requirements. Generate mockups if you can.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • プランモードを終了する前に、プランファイルの最後の見出しが ## GSTACK REVIEW REPORT であることを確認
  • レビューレポートにruns/status/findingsテーブル、VERDICT行、そしてファイルの末尾の非空白行として未解決の判断のステータスがあることを確認
  • プランファイルがコンテキストにある場合、gstack-review-logが呼び出され、gstack-review-readが少なくとも1回実行されたことを確認

OpenDesignではplan-design-reviewが同梱されています:Plugins → Skillsで、トップバーから選択してください。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Author
Garry Tan
Repository
github.com/garrytan/gstack ブランチ main
スキルファイル
plan-design-review/SKILL.md 検証時にコンテンツチェックサムを記録、コミット 71f6048
License
MIT LICENSE より。
リポジトリスター数
132,921 GitHub スナップショットは 2026-09-14 に garrytan/gstack リポジトリ全体から取得されました。このリポジトリには、カタログ内に 7 つのスキルが含まれています。plan-design-review の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign メイン版に同梱(2026-08-28 確認)。このページでは実際の実行記録はまだありません。

SKILL.md の中身

  1. このスキルを呼び出すタイミング設計プランのレビューに使用します。実装前にUI/UXプランのレビューが必要な場合に積極的に提案します
  2. 前文(最初に実行)gstack-skill-startを実行し、劣化モードを処理し、命令ブロックを読み込み、SESSION_KINDとテレメトリマーカーを設定します
  3. デザイン哲学デザインが生成されたものではなく意図的なものだと感じられるようにします。すべてのギャップを見つけ、なぜそれが重要かを説明し、明らかなものは修正します
  4. gstackデザイナー — あなたの主要ツールデザインブリーフから実際のビジュアルを作成するAIモックアップジェネレーター。UIが存在する場合はデフォルトで使用します
  5. デザイン原則9つの原則:空の状態は機能である、ヒエラルキーが重要、雰囲気より具体性、エッジケースはUXである、AIスロップは敵である、レスポンシブは意図的である、アクセシビリティは必須である、デフォルトは削減である、信頼はピクセルレベルで獲得される
  6. 認知パターン — 優れたデザイナーはどう見るか12の知覚的直感:スクリーンではなくシステムを見る、シミュレーションとしての共感、サービスとしてのヒエラルキー、制約への崇敬、疑問の反射、エッジケースへの偏執、「私なら気づくか」テスト、原則に基づいた美意識、デフォルトは削減、時間軸を考慮したデザイン、信頼のためのデザイン、ストーリーボードによるジャーニー
  7. UXの原則:ユーザーが実際にどう振る舞うか3つの法則(考えさせない、クリック数ではなく思考が重要、削って削る)、ユーザー行動(読まずに眺める、満足化、なんとかやり過ごす)、掲示板デザイン、ワイファインディングとしてのナビゲーション、信頼の貯え、モバイルはリスクが高い
  8. コンテキスト制約下での優先順位Step 0 > モックアップ > Interaction States > AI Slop > IA > User Journey;Step 0やモックアップを省略してはならない
  9. レビュー前のシステム全体点検(Step 0の前)git log、diff stat、plan、CLAUDE.md、DESIGN.md、TODOS.mdからコンテキストを収集し、UIのスコープと既存パターンを整理します
  10. デザインセットアップ(デザインモックアップコマンド実行前に行うチェック)gstack designerバイナリが利用可能かを確認し、DESIGN_READYまたはDESIGN_NOT_AVAILABLEを出力します
  11. ブレインコンテキスト(プリフライト)確認事項を尋ねる前に、gstack-brain-cacheから構造化されたプロジェクトコンテキスト(product、brand、goals、recent-decisions)を読み込みます
  12. Step 0:デザインスコープの評価初期デザイン評価0〜10、DESIGN.mdの状態確認、既存デザインの活用、フォーカス領域の質問(ユーザーの回答があるまで停止)
スキル自身による説明
「デザイナーの視点によるプラン レビュー — CEO やエンジニアのレビューと同様にインタラクティブです。(gstack)」

SKILL.md のフロントマター説明です。完全なファイルは約 72,139 文字です。完全なファイルを GitHub で読む。

Plan Design Review

実際のデザイン レビュー タスクで plan-design-review を実行します。

plan-design-review スキルは OpenDesign に同梱されています。アプリをダウンロードし、Plugins → Skills でスキルを選択し、上記のプロンプトを貼り付けて、結果の前にプランを確認してください。

ターミナル
npx skills add https://github.com/garrytan/gstack --skill plan-design-review