# nextjs-architecture-expert

Субагент для Claude, который разбирает архитектуру Next.js: App Router, Server Components, миграцию и производительность.

- субагент · `type=agent` · Claude Code · 4935 установок
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/web-tools/nextjs-architecture-expert.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/nextjs-architecture-expert

## Что делает

Этот субагент включается, когда в проекте нужно принять архитектурное решение по Next.js: выбрать между Server и Client Components, спланировать структуру `app/`, перевести приложение с Pages Router. Внутри — набор практик по App Router, работе с RSC, стримингу через `Suspense`, ISR и middleware для авторизации.

Инструменты у него простые: `Read`, `Write`, `Edit`, `Bash`, `Grep`, `Glob`. То есть он читает и правит код в репозитории, а не только советует в чате. Миграцию разбирает по шагам: параллельно держать оба роутера, превратить `_app.js` в `layout.tsx`, перенести `pages/api/` в `app/api/*/route.ts`, заменить `getServerSideProps` на Server Components и расставить `'use client'` там, где нужна интерактивность.

Полезно знать заранее: субагент рассчитан на проекты, где уже стоит Next.js с TypeScript. Если у вас Pages Router и вы не готовы трогать структуру каталогов, советы по App Router вам сейчас не пригодятся.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --agent web-tools/nextjs-architecture-expert
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/web-tools/nextjs-architecture-expert.md

## Когда брать
- спланировать структуру каталога `app/` с вложенными layout и route groups
- решить, где ставить `'use client'`, а где оставить Server Component
- перевести проект с Pages Router на App Router без остановки разработки
- настроить ISR и статическую генерацию для страниц с динамическими сегментами
- вынести проверку авторизации в `middleware.ts`

## Примеры запросов агенту
- Помоги спланировать структуру `app/` для дашборда с авторизацией и аналитикой
- Этот компонент тормозит — стоит ли вынести его в Server Component?
- Составь план миграции с Pages Router на App Router по шагам

## Похожие
- [nextjs-app-router-patterns](https://affpapa.org/nevibecode/skills/nextjs-app-router-patterns.md) — скилл · 32529 установок
- [frontend-developer](https://affpapa.org/nevibecode/agents/voltagent-community-frontend-developer.md) — субагент · 40905 установок
- [ui-ux-designer](https://affpapa.org/nevibecode/agents/ui-ux-designer.md) — субагент · 27069 установок
- [fullstack-developer](https://affpapa.org/nevibecode/agents/fullstack-developer.md) — субагент · 18117 установок
- [javascript-pro](https://affpapa.org/nevibecode/agents/javascript-pro.md) — субагент · 4974 установки
- [ui-designer](https://affpapa.org/nevibecode/agents/voltagent-community-ui-designer.md) — субагент · 1979 установок
- [ui-designer](https://affpapa.org/nevibecode/agents/ui-designer.md) — субагент · 1979 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 224 карточки

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