React/Next.js 開発ワークフロー
概要
React および Next.js 14+ アプリケーションを、App Router、サーバーコンポーネント、TypeScript、Tailwind CSS などのモダンパターンで構築するための専門ワークフローです。
このワークフローを使用するタイミング
次の場合にこのワークフローを使用します:
- 新しい React アプリケーションを構築する場合
- App Router を使用した Next.js 14+ プロジェクトを作成する場合
- サーバーコンポーネントを実装する場合
- TypeScript を React でセットアップする場合
- 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 を使用して、サーバーコンポーネントをセットアップする
フェーズ 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- サーバーコンポーネントreact-state-management- React Queryapi-patterns- API 統合
アクション
- サーバーコンポーネントの実装
- React Query/SWR のセットアップ
- API クライアントの作成
- ローディング状態の処理
- エラーバウンダリの実装
コピペ用プロンプト
@nextjs-app-router-patterns を使用して、サーバーコンポーネントのデータフェッチを実装する
フェーズ 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 パターン