К основному содержанию
правило CX Codex

server-after-nonblocking — правило для Claude Code: установка

Правило server-after-nonblocking учит агента переносить логирование, аналитику и фоновые задачи в функцию after() из Next.js. Это убирает задержку при отправке ответа клиенту.

MIT ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/server-after-nonblocking.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Бэкенд и API» →
clerk-nextjs-patterns clerk Скилл clerk-nextjs-patterns для Claude Code и Codex помогает внедрять авторизацию Clerk в Next.js. Направляет агента при настройке Server Actions, middleware и кеширования. CX Codex +1 56 200установок nextjs-core bobmatnyc Скилл nextjs-core задаёт правила разработки на Next.js App Router: серверные компоненты по умолчанию, мутации через Server Actions и точечную ревалидацию кеша. CX Codex +1 365установок nextjs-advanced-routing wsimmonds Скилл nextjs-advanced-routing для Claude Code и пяти других платформ, который учит агента работать с App Router: Route Handlers, Server Actions, Parallel Routes, Intercepting Routes и Suspense. CX Codex +1 336установок nextjs-client-cookie-pattern wsimmonds Скилл nextjs-client-cookie-pattern для Claude Code показывает, как выставить серверную куку из клиентского компонента Next.js через server action. Описывает куки для тем, авторизации и языковых настроек. CX Codex +1 326установок server-actions davepoon Помогает агенту писать Server Actions в Next.js App Router: от валидации форм через Zod до хука useFormStatus и сброса кэша. CX Codex +1 204установок nextjs-expert BuildWithClaude Community Плагин nextjs-expert для Claude Code и Cursor — пять скиллов и три слэш-команды по Next.js App Router: маршруты, серверные компоненты, формы, авторизация. ★ 3 785звёзд репо

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

Весь набор →
patterns-children-over-render-props Правило patterns-children-over-render-props для Claude Code описывает композицию React-компонентов через children вместо renderX-пропсов, в том числе для формы с разросшимися колбэками. CX Codex +1 ★ 7 191звёзд репо js-cache-function-results Правило js-cache-function-results предписывает агенту кешировать результаты повторных вызовов чистых функций через Map на уровне модуля. Это снижает лишние вычисления при рендере в React и обычном JavaScript. CX Codex +1 ★ 7 191звёзд репо client-localstorage-schema Правило client-localstorage-schema учит версионировать ключи localStorage и сохранять только нужные интерфейсу поля. Оно пригодится при работе с настройками и кэшем пользовательских данных. CX Codex +1 ★ 7 191звёзд репо client-event-listeners Правило client-event-listeners для Claude сводит глобальные подписки к одному слушателю: сколько бы компонентов ни вызывало хук, window получает один обработчик keydown. CX Codex +1 ★ 7 191звёзд репо rerender-lazy-state-init Правило rerender-lazy-state-init напоминает передавать в useState функцию, если начальное значение требует дорогих вычислений. Это пригодится в React-компонентах с данными из хранилища или сложными структурами. CX Codex +1 ★ 7 191звёзд репо async-defer-await Правило async-defer-await учит откладывать операции await только на те ветки кода, где они действительно нужны. Это избегает блокировки путей выполнения, которые могут вернуться раньше. CX Codex +1 ★ 7 191звёзд репо server-dedup-props server-dedup-props — правило для Claude Code о дедупликации данных в React Server Components. Объясняет, почему серверные трансформации массивов дублируют payload и их следует переносить в клиент. CX Codex +1 ★ 7 191звёзд репо rendering-usetransition-loading Правило rendering-usetransition-loading для Claude Code переводит индикатор загрузки в React-компонентах с ручного useState на useTransition. Спиннер живёт на отдельном флаге — правило его убирает. CX Codex +1 ★ 7 191звёзд репо

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

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