server-after-nonblocking — правило для Claude Code: установка
Правило server-after-nonblocking учит агента переносить логирование, аналитику и фоновые задачи в функцию after() из Next.js. Это убирает задержку при отправке ответа клиенту.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/server-after-nonblocking.mdЧто делает server-after-nonblocking
Правило задаёт стандарт для кода на Next.js: второстепенные операции не должны блокировать отправку HTTP-ответа. Вместо прямого вызова асинхронных логеров или систем аналитики внутри обработчика агент оборачивает их в вызов after() из модуля next/server.
Инструкция охватывает Route Handlers, Server Actions и Server Components. Она предписывает извлекать заголовки и куки внутри фонового замыкания через асинхронные await headers() и await cookies(), а не держать входящий запрос открытым ради записи телеметрии.
Код внутри after() выполнится даже в том случае, если основной ответ завершился ошибкой или вернул редирект. Поведение актуально для задач инвалидации кэша, аудита и рассылки уведомлений.
Какие задачи решает
- выносить аналитику и аудит за пределы жизненного цикла ответа
- ускорять отдачу запросов в Route Handlers и Server Actions
- запускать очистку и инвалидацию кэша после завершения запроса
- выполнять фоновую работу даже при сбое ответа или редиректе
Примеры запросов агенту
- Отрефактори этот POST-обработчик, чтобы логирование ушло в after()
- Вынеси отправку событий аналитики из Server Action в фон через after()
- Проверь роут и сделай запись аудита неблокирующей
Как установить server-after-nonblocking
Вручную: положить файлы
.claude/rules/server-after-nonblocking.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/server-after-nonblocking.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/server-after-nonblocking.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/server-after-nonblocking.mdВручную: положить файлы
.clinerules/server-after-nonblocking.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о server-after-nonblocking
Как установить server-after-nonblocking в Claude Code?
Сохраните текст правила в проект по пути .claude/rules/server-after-nonblocking.md.
Зачем нужна функция after() в коде Next.js?
Она позволяет отправить ответ пользователю без задержки, выполняя аудит, отправку метрик или инвалидацию кэша сразу после передачи данных.
В каких частях приложения работает это правило?
Паттерн применяется в Server Actions, Route Handlers и серверных компонентах Next.js.
Исходный текст
server-after-nonblocking.md · MIT
---
title: Use after() for Non-Blocking Operations
impact: MEDIUM
impactDescription: faster response times
tags: server, async, logging, analytics, side-effects
---
## Use after() for Non-Blocking Operations
Use Next.js's `after()` to schedule work that should execute after a response is sent. This prevents logging, analytics, and other side effects from blocking the response.
**Incorrect (blocks response):**
```tsx
import { logUserAction } from '@/app/utils'
export async function POST(request: Request) {
// Perform mutation
await updateDatabase(request)
// Logging blocks the response
const userAgent = request.headers.get('user-agent') || 'unknown'
await logUserAction({ userAgent })
return new Response(JSON.stringify({ status: 'success' }), {
status: 200,
headers: { 'Content-Type': 'application/json' }
})
}
```
**Correct (non-blocking):**
```tsx
import { after } from 'next/server'
import { headers, cookies } from 'next/headers'
import { logUserAction } from '@/app/utils'
export async function POST(request: Request) {
// Perform mutation
await updateDatabase(request)
// Log after response is sent
after(async () => {
const userAgent = (await headers()).get('user-agent') || 'unknown'
const sessionCookie = (await cookies()).get('session-id')?.value || 'anonymous'
logUserAction({ sessionCookie, userAgent })
})
return new Response(JSON.stringify({ status: 'success' }), {
status: 200,
headers: { 'Content-Type': 'application/json' }
})
}
```
The response is sent immediately while logging happens in the background.
**Common use cases:**
- Analytics tracking
- Audit logging
- Sending notifications
- Cache invalidation
- Cleanup tasks
**Important notes:**
- `after()` runs even if the response fails or redirects
- Works in Server Actions, Route Handlers, and Server Components
Reference: [https://nextjs.org/docs/app/api-reference/functions/after](https://nextjs.org/docs/app/api-reference/functions/after)
© tech-leads-club · MIT · tech-leads-club/agent-skills