何が共有しづらいのか
Magic Patternsが生成する管理画面モックはコンポーネントライブラリ（shadcn/uiやMUI）を使って構成されることが多く、それらのCSSやJSがバンドルされていないHTMLをそのまま送っても、受け取った側の環境でスタイルが完全に崩れて表示される。ファイル単体での共有では管理画面としての評価が成り立たない。
管理画面のモックには「ユーザー管理」「権限設定」「データエクスポート」などの機能が列挙されることが多く、それを見た業務担当者がモックの機能範囲を実装済みの機能と誤解するケースがある。共有時に「これはUI設計案のモックであり、実際の機能は実装されていない」ことを明示しないと、「この機能はいつから使えるのか」という問い合わせが来てしまう。
- 相手がログインなしで開ける状態か確認する
- PCとスマホで最低1回ずつ表示を確認する
- 内部情報・個人情報・不要な外部送信が残っていないか見る
- レビュー期限と修正時の差し替え方を決めておく
URL化する前の確認点
Magic PatternsからHTMLとして書き出す場合、shadcn/uiやRadix UIのスタイルがインラインCSSに変換されているかCDN経由で読み込まれているかを確認する。CDN経由の場合はネットワーク環境によって読み込みに失敗することがあるため、シークレットウィンドウからアクセスして表示を確認する。問題があれば各ライブラリのCDN URLをファイル内で最新バージョンに更新する。
管理画面モックに含まれるテーブルのソートやフィルター機能がJavaScriptで実装されている場合、コンソールエラーが出ていないかを確認する。エラーが残っているとレビュアーが開発者ツールを開いた際に不要な心配をさせてしまう。明らかな実装上のエラーは修正するか、エラーが出る操作を説明に注記として加えておく。
- HTML内の外部script・form action・iframeを確認する
- APIキーやトークンらしき文字列がないか検索する
- 画像・CSS・JSのパスが公開後も解決できるか見る
- noindexと認証を混同せず、必要なら両方設定する
認証と期限の決め方
管理画面モックのレビューは開発チームと業務サイドの担当者が混在することが多く、全員が同じパスワードを共有するのは管理上不便なことがある。会社ドメイン認証を使えば社員であれば各自のアカウントでアクセスできるため、パスワードの配布や変更の手間がない。レビュー範囲の説明はURLではなく別のチャンネル（Slackやメール）で伝える。
管理画面の設計は要件定義フェーズに複数回のイテレーションを経ることが多い。各イテレーションで別URLを発行し、前のURLを無効化した上で新URLをチームに通知するサイクルを繰り返すことで、どのバージョンを確認したかが明確になる。SlackのチャンネルにURLを貼るときにバージョン番号（v1、v2など）を添えておくと後から探しやすい。
- 誰でも見てよい: URL共有のみでもよいが、検索除外は確認する
- 特定の相手だけ: パスワードまたはメール認証を使う
- 会社内だけ: 会社ドメイン認証を検討する
- 短期レビュー: 期限を設定して古いURLを残さない
共有後のフィードバック回収
管理画面モックのレビューで最も価値があるのは、実際の業務担当者が「この画面の操作で自分の仕事ができるか」という視点から出す意見だ。「◯◯という業務をこの画面でやってみてください」というシナリオを渡してウォークスルーしてもらうと、設計上の穴や必要な機能の漏れが浮き彫りになりやすい。
フィードバックの収集はJiraやNotionのテーブルを使って「画面名」「問題点」「優先度」「対応者」の4列で管理すると、その後の開発タスクへの変換がスムーズだ。レビュアーから出てきた意見を口頭で受け取るだけでなく、その場でチケットに起こすか、翌日中にチケット化するルールを設けておくと抜け漏れが減る。
- 確認してほしい観点を3つ以内に絞る
- 期限と返信先を明記する
- 修正後も同じURLで見られるか伝える
- 最終版と途中版が混ざらないようタイトルを付ける
よくある質問
管理画面モックのダークモード表示もレビューしてもらいたい場合、別URLが必要ですか？
ダークモードがCSSのメディアクエリ（prefers-color-scheme）で実装されている場合はOSの設定に依存します。明示的に切り替えるトグルが実装されているなら同一URLでそのまま確認できます。
Magic PatternsのコンポーネントがTailwind CSSを使っている場合、CDNのTailwindで表示できますか？
Tailwind CDN版はユーティリティクラスを動的に生成するため基本的なクラスは表示できますが、カスタム設定（カラーパレットや独自クラス）は反映されません。完全な表示にはビルドしたCSSファイルをHTMLに同梱する必要があります。
管理画面の異なる権限ロール（管理者・一般ユーザー）の画面をそれぞれレビューしてもらいたい場合はどうすればよいですか？
権限ロールごとにHTMLファイルを分けて別URLを発行し、それぞれを対応する担当者に共有するのが最もシンプルです。「管理者ロール用URL」「一般ユーザーロール用URL」と明記して渡してください。