# nextjs-expert

Субагент nextjs-expert находит причины ошибок гидратации, настраивает Server Components и чинит маршрутизацию в проектах на Next.js 13–15.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 763 у репозитория
- Автор: carlrannaberg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/framework/framework-nextjs-expert.md
- Обновлён: 2026-03-31
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/carlrannaberg-nextjs-expert

## Что делает

Субагент специализируется на архитектуре Next.js версий с 13 по 15. Сначала он проверяет проект через консольные команды: определяет версию фреймворка в `package.json`, находит тип маршрутизации между каталогами `app` и `pages`, а также выявляет конфигурации деплоя под Vercel, Docker или Netlify.

Внутри заложены пошаговые сценарии для типичных сбоев. Помощник ищет вызовы хуков и обращений к объекту `window` в серверных компонентах с помощью `grep`, после чего предлагает трёхуровневые исправления: от директивы `use client` до выноса мутаций в Server Actions. Он также диагностирует задержки в выборке данных, сбои `generateStaticParams` и поломки инкрементальной статической регенерации (ISR).

Если вопрос касается исключительно чистых компонентов React, стилей CSS, базы данных или тестов, субагент прерывает работу и рекомендует передать задачу профильному эксперту.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/agents/framework-nextjs-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/framework-nextjs-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/framework-nextjs-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/framework/framework-nextjs-expert.md

## Когда брать
- Устранить ошибки гидратации и несовпадения серверного рендеринга с клиентским
- Исправить вызовы браузерного API и хуков React внутри Server Components
- Настроить сброс кэша и параллельную загрузку данных через `Promise.all()`
- Починить генерацию статических страниц в `generateStaticParams`

## Примеры запросов агенту
- Проверь проект и устрани ошибку hydration failed на главной странице
- Почему данные в App Router не обновляются при перезагрузке страницы?
- Помоги перенести клиентский хук из серверного компонента и сократи размер бандла

## Похожие
- [nextjs-app-router-patterns](https://affpapa.org/nevibecode/skills/nextjs-app-router-patterns.md) — скилл · 32529 установок
- [nextjs-development](https://affpapa.org/nevibecode/skills/nextjs-development.md) — скилл · 475 установок
- [nextjs-architecture-expert](https://affpapa.org/nevibecode/agents/nextjs-architecture-expert.md) — субагент · 4935 установок
- [nextjs](https://affpapa.org/nevibecode/skills/claude-skills-maintainers-nextjs.md) — скилл · 299 установок
- [nextjs-app-router-expert](https://affpapa.org/nevibecode/skills/nextjs-app-router-expert.md) — скилл · 176 установок
- [app-router](https://affpapa.org/nevibecode/skills/app-router.md) — скилл · 153 установки

## Другие версии с тем же именем
- [nextjs-expert · 0xfurai](https://affpapa.org/nevibecode/agents/0xfurai-nextjs-expert.md) — ★ 1029 у репозитория

Из того же набора: [carlrannaberg/claudekit](https://affpapa.org/nevibecode/by/carlrannaberg/claudekit.md) — 54 карточки

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

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