feature-based-frontend は何をしますか?
AIエージェントスキルは、Next.js/Reactアプリを機能ベースのアーキテクチャと階層的なデータフロー(app → features → domains → core)で構造化するためのものです。コード生成のガイド、インポート境界の強制、データフェッチ、テスト、コンポーネントパターンをカバーします。
アーキテクチャ概要
プロジェクトは以下の4つのレイヤーで構成されます(最も外側から内側へ):
- app: Next.jsのApp Routerページとルートハンドラ。このレイヤーはfeaturesとcoreのみをインポートできます。
- features: ユーザー向けの機能(ログイン、ダッシュボードなど)。各機能は独立しており、domainsとcoreをインポートできます。
- domains: ビジネスロジックとエンティティ(ユーザー、注文など)。coreに依存します。
- core: 共有のユーティリティ、型、APIクライアント。このレイヤーはどのレイヤーもインポートできません。
インポート境界
app → features, core
features → domains, core
domains → core
core → (外部ライブラリのみ)
ディレクトリ構造
src/
├── app/ # Next.js App Routerのページとルート
├── features/ # 機能モジュール
│ ├── auth/
│ ├── dashboard/
│ └── profile/
├── domains/ # ビジネスロジック
│ ├── user/
│ └── order/
└── core/ # 共有ユーティリティ
├── api/
├── types/
└── utils/
データフェッチパターン
- Server Components内で直接データフェッチを行う(
asyncコンポーネントを使用) - Client ComponentsではReact Query(TanStack Query)を使用してデータ取得とキャッシュを管理する
- データフェッチ処理はfeatures/またはdomains/内にカスタムフックまたはサービスとして分離する
- エラーハンドリングとローディング状態は各レイヤーで適切に行う
テスト戦略
- 単体テスト: core/とdomains/の関数に対して実施(Vitest + Testing Library)
- 統合テスト: features/のコンポーネントに対して実施(MSWでAPIモック)
- E2Eテスト: app/のページに対してPlaywrightまたはCypressで実施
- テストファイルはテスト対象のソースコードと同じディレクトリに配置する(例:
components/Button.tsx→components/Button.test.tsx)
コンポーネントパターン
- コンポーネントは可能な限りServer Componentとする
- 状態やインタラクションが必要な場合は、小さなClient Componentとして分離する
- コンポーネントのPropsはTypeScriptのインターフェースで明示的に定義する
- 大きなコンポーネントは複数の小さなコンポーネントに分割し、それぞれ単一責任を持つようにする
コード生成ガイド
AIエージェントは、新しい機能やコンポーネントを生成する際に、以下のルールに従うこと:
- まず、対象のレイヤーを特定する(app, features, domains, core)
- レイヤーのインポート境界を守ってコードを生成する
- 既存のコードスタイル(命名規則、フォーマット)に従う
- 常にTypeScriptの型を明示する
- 単体テストコードを同時に生成する(可能な場合)
- データフェッチは上記のパターンに従う
使用例
# 新しい機能を作成する場合
# エージェントに「features/に'search'機能を作成して」と指示する
エージェントは自動的に src/features/search/ ディレクトリを作成し、必要なコンポーネント、フック、テストファイルを生成します。