react-query-cursorrules-prompt-file — правило для Cursor: React Query
Правило для Cursor, которое задаёт агенту соглашения по React Query: где держать QueryClient, как называть хуки и ключи запросов.
.cursor/rules/react-query-cursorrules-prompt-file.mdcЧто делает react-query-cursorrules-prompt-file
Файл описывает, как писать код на React с React Query. Агент получает набор установок: функциональные компоненты с хуками, QueryClient и QueryClientProvider в корне приложения, отдельные хуки под запросы и мутации, ключи запросов для кеша, префетчинг, состояния загрузки и ошибок.
Структура папок задана заранее: src/components, src/hooks с подпапками useQueries и useMutations, src/pages, src/utils, src/api. Дальше идут дополнительные пункты — TypeScript, error boundaries под ошибки запросов, React Query DevTools, стратегия stale-while-revalidate, оптимистичные обновления мутаций, инвалидация запросов и единые имена по конвенциям библиотеки.
Правило применяется к файлам по маске **/*, но alwaysApply стоит в false — значит, его нужно подключать осознанно, иначе оно будет влиять на весь проект. Если вы уже держите свою раскладку папок или пишете на JavaScript без типов, часть пунктов придётся переписать под себя.
Какие задачи решает
- задать агенту единый стиль работы с React Query
- разложить хуки запросов и мутаций по отдельным папкам
- договориться об именовании ключей запросов и кеше
- добавить обработку ошибок и состояний загрузки в запросы
- включить оптимистичные обновления и инвалидацию в мутациях
Примеры запросов агенту
- Создай хук запроса списка задач в
src/hooks/useQueriesпо правилам React Query - Добавь мутацию создания задачи с оптимистичным обновлением и инвалидацией
- Настрой
QueryClientProviderв корне приложения и вынеси ключи запросов в отдельный модуль
Как установить react-query-cursorrules-prompt-file
Вручную: положить файлы
.cursor/rules/react-query-cursorrules-prompt-file.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/react-query-cursorrules-prompt-file.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/react-query-cursorrules-prompt-file.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/react-query-cursorrules-prompt-file.mdВручную: положить файлы
.clinerules/react-query-cursorrules-prompt-file.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о react-query-cursorrules-prompt-file
Как установить react-query-cursorrules-prompt-file в Cursor?
Создайте файл .cursor/rules/react-query-cursorrules-prompt-file.mdc в корне проекта и вставьте в него содержимое правила.
Что делает react-query-cursorrules-prompt-file?
Задаёт агенту Cursor соглашения по React Query: расположение QueryClient, отдельные хуки под запросы и мутации, ключи для кеша, префетчинг, обработку ошибок и загрузки.
Правило применяется ко всем файлам автоматически?
Маска globs — **/*, но alwaysApply выставлен в false, поэтому правило подключается вручную.
Исходный текст
react-query-cursorrules-prompt-file.mdc · CC0-1.0
---
description: "Cursor rules for React development with React Query integration."
globs: **/*
alwaysApply: false
---
// React + React Query .cursorrules
// Prefer functional components with hooks
const preferFunctionalComponents = true;
// React Query best practices
const reactQueryBestPractices = [
"Use QueryClient and QueryClientProvider at the root of your app",
"Implement custom hooks for queries and mutations",
"Utilize query keys for effective caching",
"Use prefetching for improved performance",
"Implement proper error and loading states",
];
// Folder structure
const folderStructure = `
src/
components/
hooks/
useQueries/
useMutations/
pages/
utils/
api/
`;
// Additional instructions
const additionalInstructions = `
1. Use TypeScript for type safety with React Query
2. Implement proper error boundaries for query errors
3. Utilize React Query DevTools for debugging
4. Use stale-while-revalidate strategy for data freshness
5. Implement optimistic updates for mutations
6. Use query invalidation for data refetching
7. Follow React Query naming conventions for consistency
`;
© PatrickJS · CC0-1.0 · PatrickJS/awesome-cursorrules