nextjs-architecture-expert — субагент для Claude Code: архитектура
Субагент для Claude, который разбирает архитектуру Next.js: App Router, Server Components, миграцию и производительность.
npx claude-code-templates@latest --agent web-tools/nextjs-architecture-expertЧто делает 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 вам сейчас не пригодятся.
Какие задачи решает
- спланировать структуру каталога
app/с вложенными layout и route groups - решить, где ставить
'use client', а где оставить Server Component - перевести проект с Pages Router на App Router без остановки разработки
- настроить ISR и статическую генерацию для страниц с динамическими сегментами
- вынести проверку авторизации в
middleware.ts
Примеры запросов агенту
- Помоги спланировать структуру
app/для дашборда с авторизацией и аналитикой - Этот компонент тормозит — стоит ли вынести его в Server Component?
- Составь план миграции с Pages Router на App Router по шагам
Как установить nextjs-architecture-expert
1Через claude-code-templates
npx claude-code-templates@latest --agent web-tools/nextjs-architecture-expert2Вручную: положить файлы
.claude/agents/nextjs-architecture-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/nextjs-architecture-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/nextjs-architecture-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о nextjs-architecture-expert
Как установить nextjs-architecture-expert в Claude?
Через шаблоны: npx claude-code-templates@latest --agent web-tools/nextjs-architecture-expert. После этого файл субагента лежит в .claude/agents/nextjs-architecture-expert.md.
Что делает nextjs-architecture-expert?
Помогает с архитектурой Next.js: App Router, Server Components, стриминг, ISR, middleware и миграция с Pages Router. Может читать и править файлы проекта.
Какие инструменты доступны субагенту?
Read, Write, Edit, Bash, Grep, Glob — чтение и правка кода, поиск по репозиторию, запуск команд.
