React/Next.js開発ワークフロー
選択的読み取りルール
次のドキュメントから始めてください:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
その後、ユーザーの実際のタスクに一致する継承されたドキュメント、スクリプト、アセット、または例のみを読み込みます。
概要
ReactおよびNext.js 14+アプリケーションを、App Router、Server Components、TypeScript、Tailwind CSSを含むモダンパターンで構築するための、専門化されたワークフローです。
このワークフローを使用するタイミング
次の場合にこのワークフローを使用します:
- 新しいReactアプリケーションを構築する場合
- App Routerを使用してNext.js 14+プロジェクトを作成する場合
- Server Componentsを実装する場合
- ReactでTypeScriptをセットアップする場合
- Tailwind CSSでスタイリングする場合
- フルスタックNext.jsアプリケーションを構築する場合
ワークフローフェーズ
フェーズ1: プロジェクトセットアップ
呼び出すスキル
app-builder- アプリケーションスキャフォールディングsenior-fullstack- フルスタックガイダンスnextjs-app-router-patterns- Next.js 14+パターンtypescript-pro- TypeScriptセットアップ
アクション
- プロジェクトタイプを選択(React SPA、Next.jsアプリ)
- ビルドツールを選択(Vite、Next.js、Create React App)
- プロジェクト構造をスキャフォールド
- TypeScriptを設定
- ESLintとPrettierを設定
コピー&ペースト用プロンプト
@app-builderを使用して、App Routerで新しいNext.js 14プロジェクトをスキャフォールドする
@nextjs-app-router-patternsを使用して、Server Componentsを設定する
フェーズ2: コンポーネントアーキテクチャ
呼び出すスキル
frontend-developer- コンポーネント開発react-patterns- Reactパターンreact-state-management- 状態管理react-ui-patterns- UIパターン
アクション
- コンポーネント階層を設計
- ベースコンポーネントを作成
- レイアウトコンポーネントを実装
- 状態管理をセットアップ
- カスタムフックを作成
コピー&ペースト用プロンプト
@frontend-developerを使用して、再利用可能なReactコンポーネントを作成する
@react-patternsを使用して、適切なコンポーネント構成を実装する
@react-state-managementを使用して、Zustandストアをセットアップする
フェーズ3: スタイリングとデザイン
呼び出すスキル
frontend-design- UIデザインtailwind-patterns- Tailwind CSStailwind-design-system- デザインシステムcore-components- コンポーネントライブラリ
アクション
- Tailwind CSSをセットアップ
- デザイントークンを設定
- ユーティリティクラスを作成
- コンポーネントスタイルを構築
- レスポンシブデザインを実装
コピー&ペースト用プロンプト
@tailwind-patternsを使用して、Tailwind CSS v4でコンポーネントをスタイリングする
@frontend-designを使用して、モダンなダッシュボードUIを作成する
フェーズ4: データ取得
呼び出すスキル
nextjs-app-router-patterns- Server Componentsreact-state-management- React Queryapi-patterns- API統合
アクション
- Server Componentsを実装
- React Query/SWRをセットアップ
- APIクライアントを作成
- ローディング状態を処理
- エラーバウンダリを実装
コピー&ペースト用プロンプト
@nextjs-app-router-patternsを使用して、Server Componentsのデータ取得を実装する
フェーズ5: ルーティングとナビゲーション
呼び出すスキル
nextjs-app-router-patterns- App Routernextjs-best-practices- Next.jsパターン
アクション
- ファイルベースのルーティングをセットアップ
- 動的ルートを作成
- ネストされたルートを実装
- ルートガードを追加
- リダイレクトを設定
コピー&ペースト用プロンプト
@nextjs-app-router-patternsを使用して、パラレルルートとインターセプトルートをセットアップする
フェーズ6: フォームとバリデーション
呼び出すスキル
frontend-developer- フォーム開発typescript-advanced-types- 型バリデーションreact-ui-patterns- フォームパターン
アクション
- フォームライブラリを選択(React Hook Form、Formik)
- バリデーションを設定(Zod、Yup)
- フォームコンポーネントを作成
- 送信を処理
- エラーハンドリングを実装
コピー&ペースト用プロンプト
@frontend-developerを使用して、React Hook FormとZodでフォームを作成する
フェーズ7: テスト
呼び出すスキル
javascript-testing-patterns- Jest/Vitestplaywright-skill- E2Eテストe2e-testing-patterns- E2Eパターン
アクション
- テストフレームワークをセットアップ
- 単体テストを作成
- コンポーネントテストを作成
- E2Eテストを実装
- CI統合を設定
コピー&ペースト用プロンプト
@javascript-testing-patternsを使用して、Vitestテストを作成する
@playwright-skillを使用して、重要なフローのE2Eテストを作成する
フェーズ8: ビルドとデプロイメント
呼び出すスキル
vercel-deployment- Vercelデプロイメントvercel-deploy-claimable- Vercelデプロイメントweb-performance-optimization- パフォーマンス
アクション
- ビルド設定を構成
- バンドルサイズを最適化
- 環境変数をセットアップ
- Vercelにデプロイ
- プレビューデプロイメントを設定
コピー&ペースト用プロンプト
@vercel-deploymentを使用して、Next.jsアプリを本番環境にデプロイする
技術スタック
| カテゴリ | 技術 |
|---|---|
| フレームワーク | Next.js 14+、React 18+ |
| 言語 | TypeScript 5+ |
| スタイリング | Tailwind CSS v4 |
| 状態管理 | Zustand、React Query |
| フォーム | React Hook Form、Zod |
| テスト | Vitest、Playwright |
| デプロイメント | Vercel |
品質ゲート
- TypeScriptがエラーなくコンパイルする
- すべてのテストが合格する
- リンティングがクリーン
- パフォーマンス指標を満たす(LCP、CLS、FID)
- アクセシビリティが確認済み(WCAG 2.1)
- レスポンシブデザインが確認済み
関連ワークフローバンドル
development- 一般的な開発testing-qa- テストワークフローdocumentation- ドキュメンテーションtypescript-development- TypeScriptパターン
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代用として扱わないでください。
- 必要な入力、権限、安全境界、成功基準が不足している場合は、質問して明確にしてください。