async-api-routes — правило для Claude Code
Правило async-api-routes устраняет цепочки водопадов в обработчиках API и Server Actions. Оно запускает независимые асинхронные вызовы сразу, не дожидаясь завершения других промисов.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/async-api-routes.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/async-api-routes.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/async-api-routes.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/async-api-routes.mdВручную: положить файлы
.clinerules/async-api-routes.mdПо шагам, с командами для каждой платформы: 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