К основному содержанию
субагент CX Codex

nextjs-developer · voltagent/awesome-codex-subagents — субагент для Codex: задачи Next.js

Субагент nextjs-developer разбирает и меняет поведение Next.js в маршрутах, рендеринге и работе с данными. Вызывайте его для точечной правки, где важны серверная и клиентская границы.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/nextjs-developer.toml
Открыть на GitHub

Что делает nextjs-developer

Субагент сначала прослеживает точку входа, путь данных и внешние зависимости, затем ищет причину сбоя или пробел в проектировании. Он предлагает минимальную связную правку, которая сохраняет поведение вне задачи. В фокусе — App Router и Page Router, Server Actions, API routes, кэширование SSR/ISR/RSC и передача сессии между сервером и браузером.

После изменений он проверяет затронутый путь, один сценарий сбоя и границу интеграции. Также оценивает гидратацию, состояния загрузки и ошибок, сериализацию и риск устаревших данных. Для edge и node нужны отдельные проверки окружения, поэтому локальная проверка сама по себе не подтверждает поведение при деплое.

В ответе субагент указывает модуль и границу исполнения, объясняет проблему, предлагает исправление с компромиссом и перечисляет, что проверено, а что требует проверки в окружении. Он не перестраивает всю архитектуру приложения ради локальной правки, если этого отдельно не попросили.

Какие задачи решает

  • найти причину ошибки маршрута при клиентской навигации
  • проверить границу между серверными и клиентскими компонентами
  • разобрать риск устаревших данных при инвалидации кэша
  • проверить передачу сессии между сервером и браузером
  • оценить различия edge- и node-развёртывания

Примеры запросов агенту

  • Разбери, почему маршрут работает при первой загрузке, но ломается при клиентской навигации.
  • Проверь Server Action и границу между серверной и клиентской частями этого изменения.
  • Найди риск устаревших данных в кэшировании SSR и предложи небольшую правку.

Как установить nextjs-developer

Вручную: положить файлы

.codex/agents/nextjs-developer.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о nextjs-developer

Как установить nextjs-developer в Codex?

Добавьте файл субагента по пути .codex/agents/nextjs-developer.toml.

Что делает nextjs-developer?

Он разбирает задачи Next.js, находит проблему на границе исполнения и предлагает небольшое исправление. Затем проверяет затронутый сценарий и обозначает оставшиеся риски.

Что он проверяет при изменении серверных и клиентских компонентов?

Он учитывает сериализацию и утечки секретов, а также поведение гидратации и границ ошибок. Для edge- и node-развёртывания нужны отдельные проверки окружения.

Исходный текст

nextjs-developer.toml · MIT
# nextjs-developer

Use when a task needs Next.js-specific work across routing, rendering modes, server actions, data fetching, or deployment-sensitive frontend behavior.

Own Next.js tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- App Router/Page Router boundaries and route behavior correctness
- server vs client component boundaries and serialization constraints
- data fetching and cache invalidation semantics (SSR/ISR/RSC)
- server actions and API route contract safety
- auth/session propagation across server and browser boundaries
- build/deploy-sensitive behavior (edge/runtime differences)
- user-visible loading/error states and hydration stability

Quality checks:
- verify route behavior across initial render and client navigation
- confirm hydration, suspense, and error boundary behavior in changed paths
- check cache invalidation strategy for stale-data risk
- ensure server/client boundary changes do not leak secrets or break serialization
- call out runtime-specific checks needed for edge vs node deployments

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not redesign full app architecture or routing strategy for a localized fix unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

Сначала — nextjs-developer от других авторов.

nextjs-developer VoltAgent Community Субагент nextjs-developer проектирует и пишет full-stack приложения на Next.js 14+ с App Router. Он помогает настроить Server Actions, оптимизировать Core Web Vitals и подготовить SEO. CX Codex 898установок material-ui-nextjs mui Скилл material-ui-nextjs для связки Material UI с Next.js: SSR, кеш Emotion, next/font, CSS-слои, Link и useSearchParams. Пригодится при настройке или отладке MUI в Next.js-приложении. CX Codex +1 776установок nextjs-expert 0xfurai Субагент nextjs-expert для Claude Code помогает проектировать Next.js-приложения, API-маршруты и React-интерфейсы. Подключается к задачам по SSR, SSG и маршрутизации. CX Codex ★ 1 029звёзд репо nextjs-typescript-tailwindcss-supabase Mindrally Скилл nextjs-typescript-tailwindcss-supabase задаёт агенту правила для Next.js 14, TypeScript, TailwindCSS и Supabase: серверные компоненты, обработка ошибок, читаемый код. CX Codex +1 1 400установок vinext-vite-nextjs reason-machines Скилл vinext-vite-nextjs помогает перевести проект с Next.js на Vite и подготовить сборку для Cloudflare Workers. Поддерживает Pages Router и App Router. CX Codex +1 1 400установок nextjs Claude Skills Maintainers Скилл для работы с Next.js 16, React 19.2 и современными паттернами серверных компонентов, Server Actions и кэширования. Помогает при миграции с версии 15, ошибках async params и настройке Partial Prerendering. CX Codex +1 299установок nextjs-dynamic-routes-params wsimmonds Скилл nextjs-dynamic-routes-params для Claude Code строит динамические сегменты App Router и читает params в Next.js 15+. Покрывает маршруты по ID или слагу. CX Codex +1 304установок

Из того же набора176

Весь набор →
powershell-7-expert Субагент powershell-7-expert помогает писать надёжные скрипты на PowerShell 7 для Linux, macOS и Windows, настраивать пайплайны и интеграцию с .NET. CX Codex ★ 6 505звёзд репо powershell-5.1-expert Субагент powershell-5.1-expert помогает разбирать и менять скрипты Windows PowerShell 5.1 с учётом .NET Framework, remoting и административных ограничений. CX Codex ★ 6 505звёзд репо php-pro Субагент php-pro для работы с PHP-кодом: помогает разобраться в логике приложения, интегрировать фреймворки, отладить runtime-ошибки и безопасно менять серверный код. Подходит, когда нужна глубокая экспертиза в PHP, а не просто синтаксис. CX Codex ★ 6 505звёзд репо node-specialist Субагент node-specialist для бэкенда на Node.js. Контролирует блокировки event loop, стримы, утечки ресурсов и корректность асинхронных цепочек. CX Codex ★ 6 505звёзд репо laravel-specialist Субагент laravel-specialist для задач по маршрутизации, Eloquent, очередям, валидации и архитектуре Laravel. Ищет корень проблемы в граничных точках, предлагает минимальные безопасные правки и проверяет атомарность данных. CX Codex ★ 6 505звёзд репо kotlin-specialist Субагент kotlin-specialist для задач на Kotlin в JVM-сервисах и Android. Исправляет ошибки в корутинах, типах и контрактах без переписывания архитектуры. CX Codex ★ 6 505звёзд репо javascript-pro Субагент javascript-pro разбирает JavaScript для браузера и Node.js: ищет причины ошибок, меняет код и проверяет затронутые пути выполнения. CX Codex ★ 6 505звёзд репо java-architect java-architect — субагент для архитектурных задач Java-приложений. Анализирует структуру кодовых баз, поведение JVM и границы фреймворков, выявляет корневые причины и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой