---

name: graphql-guide description: GraphQL development best practices. Use when working with fragments, queries, mutations, or .graphql files.

GraphQL Guide

命名パターン（ベストプラクティス）

ファイル命名

Copy<type>.<GraphQLName>.graphql

• type: fragment | query | mutation | subscription
• GraphQLName: PascalCaseで記述

パターン別

コロケーションパターン

GraphQLファイルは使用するコンポーネントの近くに配置:

Copycomponents/
└── UserCard/
    ├── index.tsx
    └── graphql/
        └── fragment.UserCard.graphql

Verb一覧（Mutation用）

Fragment First

1. コンポーネントが必要なデータをFragmentで定義
2. 親がFragmentをQuery/Mutationに埋め込み
3. データの責務が明確になる

Copy# fragment.UserCard.graphql
fragment UserCardFragment on User {
  id
  name
  avatarUrl
}

# query.GetUsers.graphql
query GetUsersQuery {
  users {
    ...UserCardFragment
  }
}