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

async-api-routes — правило для Claude Code

Правило async-api-routes устраняет цепочки водопадов в обработчиках API и Server Actions. Оно запускает независимые асинхронные вызовы сразу, не дожидаясь завершения других промисов.

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

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

Что делает async-api-routes

Инструкция нацелена на эндпоинты, где независимые операции выполняются по очереди через последовательные await. Правило требует инициализировать промисы немедленно при входе в функцию: пока проверяется сессия пользователя, параллельно запрашивается конфигурация, а ожидание происходит через Promise.all.

Для разветвлённых графов вызовов правило рекомендует библиотеку better-all, которая строит параллельное выполнение на основе зависимостей. Если в кодовой базе нет такой утилиты, а цепочки ветвятся, параллелизацию придётся связывать вручную стандартными промисами.

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

  • устранить последовательные await в серверных обработчиках
  • распараллелить получение конфигурации и проверку сессии
  • переписать Server Actions без искусственных задержек
  • оптимизировать время ответа эндпоинта через Promise.all

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

  • Перепиши этот API route, чтобы независимые запросы выполнялись параллельно
  • Проверь Server Action на наличие водопадов в асинхронных вызовах
  • Оптимизируй функцию GET с помощью немедленного запуска промисов

Как установить async-api-routes

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

.claude/rules/async-api-routes.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы об async-api-routes

Как установить async-api-routes в Claude Code?

Сохраните правило по пути .claude/rules/async-api-routes.md в корне вашего проекта.

Что делает правило async-api-routes?

Оно запрещает блокировать независимые сетевые вызовы последовательными await. Агент сразу начинает выполнение функций и объединяет результат через Promise.all.

Что использовать для сложных графов зависимостей?

В ситуациях, когда одни промисы зависят от результатов других, правило советует подключать утилиту better-all.

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

async-api-routes.md · MIT
---
title: Prevent Waterfall Chains in API Routes
impact: CRITICAL
impactDescription: 2-10× improvement
tags: api-routes, server-actions, waterfalls, parallelization
---

## Prevent Waterfall Chains in API Routes

In API routes and Server Actions, start independent operations immediately, even if you don't await them yet.

**Incorrect (config waits for auth, data waits for both):**

```typescript
export async function GET(request: Request) {
  const session = await auth()
  const config = await fetchConfig()
  const data = await fetchData(session.user.id)
  return Response.json({ data, config })
}
```

**Correct (auth and config start immediately):**

```typescript
export async function GET(request: Request) {
  const sessionPromise = auth()
  const configPromise = fetchConfig()
  const session = await sessionPromise
  const [config, data] = await Promise.all([
    configPromise,
    fetchData(session.user.id)
  ])
  return Response.json({ data, config })
}
```

For operations with more complex dependency chains, use `better-all` to automatically maximize parallelism (see Dependency-Based Parallelization).

© tech-leads-club · MIT · tech-leads-club/agent-skills

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

Все правила IDE по теме «Бэкенд и API» →
async-parallel jarrodwatts Правило async-parallel для Claude Code запускает независимые асинхронные вызовы параллельно через Promise.all(), а не по очереди. Заменяет последовательные await в обработчиках. CX Codex +1 ★ 1 064звёзд репо expo-api-routes официальный Expo Team Скилл expo-api-routes для Codex объясняет, как писать серверные API-роуты в Expo Router и выкладывать их на EAS Hosting. Держит ключи и запросы к базе на сервере, не на клиенте. CX Codex GP ChatGPT +1 1установок async-expert martinholovsky Скилл async-expert направляет агента при написании асинхронного кода на Python, JavaScript, C# и Rust с упором на TDD и защиту от выдуманных API. CX Codex +1 212установок csharp-async официальный github Скилл csharp-async для GitHub Copilot, который проверяет асинхронный код на C# и подсказывает, как привести его к принятым практикам. Включается при ревью и написании методов с Task и await. CX Codex +1 10 883установок rust-async-patterns Seth Hobson Скилл rust-async-patterns для Claude Code помогает писать и разбирать асинхронный Rust на Tokio: задачи, каналы, потоки и обработку ошибок. Помогает создавать сетевые сервисы и отлаживать код. CX Codex +1 20 625установок unit-test-scheduled-async giuseppe-trisciuoglio Скилл unit-test-scheduled-async с готовыми шаблонами юнит-тестов для Spring-методов @Scheduled и @Async: JUnit 5, CompletableFuture, Awaitility, Mockito. CX Codex +1 3 900установок

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

Весь набор →
js-hoist-regexp Правило js-hoist-regexp для Claude про регулярки в React: шаблон не создаётся внутри рендера, а живёт в модуле или в useMemo(). CX Codex +1 ★ 7 191звёзд репо rendering-hoist-jsx Правило rendering-hoist-jsx выносит неизменяемые JSX-элементы за пределы компонентов, чтобы они не создавались заново при каждом рендере. CX Codex +1 ★ 7 191звёзд репо rerender-transitions Правило rerender-transitions для Claude Code предлагает выносить частые несрочные обновления состояния React-интерфейса в transitions. Для значения прокрутки в обработчике scroll обновление выполняется как несрочное. CX Codex +1 ★ 7 191звёзд репо advanced-use-latest Правило advanced-use-latest для Claude показывает, как в эффектах React брать свежий колбэк, не добавляя его в массив зависимостей. CX Codex +1 ★ 7 191звёзд репо js-early-exit Правило js-early-exit для Claude Code задаёт немедленный возврат результата, как только он определён. Останавливает проверку после первой найденной ошибки. CX Codex +1 ★ 7 191звёзд репо rerender-memo Правило rerender-memo учит агента выносить дорогие вычисления в отдельные мемоизированные компоненты, чтобы избежать лишних расчётов при ранних возвратах. Помогает ускорить рендеринг в React-приложениях. CX Codex +1 ★ 7 191звёзд репо bundle-preload Правило bundle-preload учит агента предзагружать тяжёлые бандлы при наведении курсора или включении фичефлага. Это снижает видимую задержку интерфейса. CX Codex +1 ★ 7 191звёзд репо client-swr-dedup Правило client-swr-dedup для Claude Code предлагает использовать SWR, чтобы компоненты делили запросы и получали данные из кэша. Описывает клиентскую загрузку данных в React. CX Codex +1 ★ 7 191звёзд репо

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

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