Community研究&データ分析github.com

sandylib/feature-based-frontend

Next.js/Reactアプリを機能ベースのアーキテクチャと階層的なデータフロー(app → features → domains → core)で構築するためのAIエージェントスキルです。コード生成のガイド、インポート境界の強制、データフェッチ、テスト、コンポーネントパターンをカバーします。

feature-based-frontend とは?

このスキルは、Next.jsやReactアプリケーションを機能ベースのアーキテクチャで構造化する際に、AIエージェント(Claude Code、Cursor、Codexなど)をガイドします。具体的には、コード生成時に階層的なデータフロー(app → features → domains → core)に従ったフォルダ構成やインポートルールを自動的に提案・強制することで、プロジェクトの保守性とスケーラビリティを向上させます。また、データフェッチ、ユニットテスト、コンポーネントパターンなど、実践的な開発パターンに関する指示も含まれており、エージェントが一貫性のあるコードを生成できるように支援します。SKILL.mdには、ディレクトリ構造の定義、インポート境界のルール、テスト戦略、データフローの設計指針が詳細に記載されており、これを読み込んだエージェントがユーザーの指示に従って適切なコードを生成・修正できるようになります。

対応~Claude Code~Codex CLI~Cursor
npx skills add sandylib/feature-based-frontend

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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エージェントは、新しい機能やコンポーネントを生成する際に、以下のルールに従うこと:

  1. まず、対象のレイヤーを特定する(app, features, domains, core)
  2. レイヤーのインポート境界を守ってコードを生成する
  3. 既存のコードスタイル(命名規則、フォーマット)に従う
  4. 常にTypeScriptの型を明示する
  5. 単体テストコードを同時に生成する(可能な場合)
  6. データフェッチは上記のパターンに従う

使用例

# 新しい機能を作成する場合
# エージェントに「features/に'search'機能を作成して」と指示する

エージェントは自動的に src/features/search/ ディレクトリを作成し、必要なコンポーネント、フック、テストファイルを生成します。

参考リンク

関連スキル