# tanstack-query-v5-cursorrules-prompt-file

Правило для Cursor, которое задаёт агенту стиль работы с TanStack Query v5: ключи запросов, мутации, оптимистичные обновления, Suspense и префетчинг.

- правило · `type=rule` · Cursor · ★ 41011
- Автор: PatrickJS
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/PatrickJS/awesome-cursorrules/tree/HEAD/rules/tanstack-query-v5-cursorrules-prompt-file.mdc
- Обновлён: 2026-05-30
- HTML: https://affpapa.org/nevibecode/rules/tanstack-query-v5-cursorrules-prompt-file

## Что делает

Это файл правил для Cursor, который подключается к проекту и описывает, как писать код на TanStack Query v5. Внутри — набор соглашений: ключи запросов всегда массивами, фабрика ключей вместо строк, разделение чтения и записи между `useQuery` и `useMutation`, хелпер `queryOptions()` для переиспользуемых определений.

Правило разбирает и практические куски: настройку `QueryClient` в `main.tsx`, оптимистичные обновления через `onMutate` с откатом в `onError`, бесконечные запросы с `getNextPageParam`, префетчинг по наведению и в лоадерах роутера, инвалидацию кэша. Отдельно отмечено ломающее изменение v5: `useQuery` больше не принимает позиционные аргументы, только объект с опциями. Если в проекте ещё висят вызовы старого вида, правило будет тянуть их к новому синтаксису — это повод проверить код до подключения.

Есть разделы про Suspense с `useSuspenseQuery`, обработку ошибок через `throwOnError` и условный `retry`, а также заметки по TypeScript. Правило не применяется автоматически: в frontmatter стоит `alwaysApply: false`, а `globs` задан как `**/*`.

## Установка

### Cursor (родная платформа)

**Вручную: положить файлы**
- Файл: `.cursor/rules/tanstack-query-v5-cursorrules-prompt-file.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/tanstack-query-v5-cursorrules-prompt-file.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/tanstack-query-v5-cursorrules-prompt-file.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/tanstack-query-v5-cursorrules-prompt-file.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/tanstack-query-v5-cursorrules-prompt-file.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PatrickJS/awesome-cursorrules/tree/HEAD/rules/tanstack-query-v5-cursorrules-prompt-file.mdc

## Когда брать
- привести ключи запросов к единому виду через фабрику
- переписать вызовы useQuery под объектную форму v5
- сделать оптимистичное обновление с откатом при ошибке
- настроить бесконечную подгрузку списка по курсору
- убрать спиннеры за счёт префетчинга в лоадере

## Примеры запросов агенту
- Создай фабрику ключей запросов для сущности post по правилам TanStack Query v5
- Добавь мутацию создания поста с инвалидацией списка и тостом об успехе
- Переведи этот компонент на useSuspenseQuery с Suspense и ErrorBoundary

## Похожие
- [tanstack-query](https://affpapa.org/nevibecode/skills/tanstack-query.md) — скилл · 9900 установок
- [tanstack-query-best-practices](https://affpapa.org/nevibecode/skills/tanstack-query-best-practices.md) — скилл · 12800 установок
- [react-query](https://affpapa.org/nevibecode/skills/react-query.md) — скилл · 1400 установок
- [router-query](https://affpapa.org/nevibecode/skills/router-query.md) — скилл · 366 установок
- [react-vite-dashboard](https://affpapa.org/nevibecode/skills/react-vite-dashboard.md) — скилл · 5500 установок
- [clerk-tanstack-patterns](https://affpapa.org/nevibecode/skills/clerk-tanstack-patterns.md) — скилл · 15500 установок

Из того же набора: [patrickjs/awesome-cursorrules](https://affpapa.org/nevibecode/by/patrickjs/awesome-cursorrules.md) — 68 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md