react-requirements-workshop
Reactの動く画面案やDesign Systemの部品を使って、要件をすり合わせたいときに使います。画面案とレビューUIを一つの作業領域で管理します。
渡す情報
対象ユーザー、達成したいこと、画面・操作、参照デザイン、保存先を渡します。
依頼例
react-requirements-workshopを使って、依頼一覧の操作をReact画面案で確認したいです。担当者フィルターと未対応表示を試せる案を作り、指摘を次の案へ反映してください。
進め方
- 目的を確認し、画面案の依頼後に作業領域を初期化します。
- 同梱Design Systemを確認してTSXとJSONの案を追加し、型・表示・注釈を検証します。
- 画面案を固定してコメントを受け、新しい番号へ反映します。承認済みの画面と要件を保管します。
成果物の例
Design System部品を導入して生成したReact画面案です。表示一式とソースを別々のZIPで取得できます。
到達点:初回画面案生成・検証済み/内容の承認待ち。
移行時の確認:既存の実行記録を移行しました。本文の一致は確認しましたが、過去の実行時の同梱資料全体は特定できていません。
このハッシュは移行時の変更検出用の基準です。同梱資料全体をこの版で再実行した証拠ではありません。
実行した依頼
unknownsの実出力を読むReact画面案を、Design Systemのdetail-pageで作ってください。抜粋と全文の切り替え、Markdown原本取得を用意し、初回案のTSX・JSON・表示一式を保存して検証してください。
実際の画面

表示ZIPは展開してローカルサーバーで開けます。ソースZIPには導入済み部品を含み、npm ci → npm run devで確認できます。公開Registryの404に対してローカル正本を使った経緯は検証記録に残しています。
成果物を取得する
- 生成した要件(Markdown)
- 生成に使った入力(JSON)
- 生成した画面一式(ZIP)
- 画面ソース一式(ZIP)
- ブラウザ検証結果(環境パスを伏せたJSON)
- 実行入力の原本
- 実行・検証記録(JSON)
確認した結果
- 公開Registryのdetail-page.jsonは404。提供元のローカル正本コピーをshadcn buildし、同じRegistryからview/addで導入。
- validate_snapshot、typecheck、lint、freeze_snapshotのproduction build成功。
- ブラウザ検証は初回に必要なChromium版を起動できず失敗。対応する設定で既存Chromeを指定して再実行。
- 1568×784、1280×800、1024×768、800×900の注釈、モード分離、画面枠の検証がすべてvalid。
確認するポイント
これは保存物の一部を示す構造例です。TSXとJSONの対応、実際に提示した画面のzip、指摘の反映と承認履歴を確認します。既存のアプリとサーバーを案ごとに初期化し直しません。
関連するスキル
- html-requirements-workshop:単体HTMLで議論する。
- plan:合意した画面を実装計画へ渡す。
正本を読む
詳細な手順と制約はreact-requirements-workshopのSKILL.mdを参照してください。