async-defer-await — правило для Claude Code: оптимизация await
Правило async-defer-await учит откладывать операции await только на те ветки кода, где они действительно нужны. Это избегает блокировки путей выполнения, которые могут вернуться раньше.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/async-defer-await.mdЧто делает async-defer-await
Когда await стоит в начале функции, он блокирует весь код до получения результата — даже если дальше есть ранний выход. Это правило предлагает переместить await внутрь условных ветвей, чтобы они срабатывали только когда нужно.
Примеры показывают две ситуации: функция с условием skipProcessing, которая возвращается без использования данных, и обработка ресурса с проверкой существования. В обоих случаях переордеринг операций даёт выигрыш — код не ждёт, если результат не понадобится.
Оптимизация важна, когда ранний выход срабатывает часто или когда отложенная операция дорогостоящая (сетевой запрос, база данных). Правило работает в Claude Code через файл .claude/rules/async-defer-await.md.
Какие задачи решает
- Избежать блокировки кода, который может вернуться без результата await
- Переупорядочить проверки и условия перед асинхронными вызовами
- Сократить время отклика в функциях с ранними выходами
- Оптимизировать дорогостоящие асинхронные операции
Примеры запросов агенту
- Проверь функцию handleRequest: await стоит до if, переместим его внутрь ветки
- Проанализируй updateResource — нужно получить ресурс перед правами, await fetchPermissions отложим
- Найди все места, где await блокирует return, и переделай на условные await
Как установить async-defer-await
Вручную: положить файлы
.claude/rules/async-defer-await.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/async-defer-await.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/async-defer-await.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/async-defer-await.mdВручную: положить файлы
.clinerules/async-defer-await.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об async-defer-await
Как установить async-defer-await в Claude Code?
Создай файл .claude/rules/async-defer-await.md в корне проекта с содержимым правила. Claude Code подхватит его автоматически при следующем запуске.
Что даёт это правило?
Оно показывает, как переместить await из начала функции в те ветки, где результат действительно используется. Код выполняется быстрее, потому что не ждёт ненужные операции.
Когда оптимизация имеет смысл?
Когда ранний выход срабатывает часто или когда отложенная операция дорогостоящая (сетевой запрос, запрос к БД). Если все ветки нужны, await в начале допустим.
Исходный текст
async-defer-await.md · MIT
---
title: Defer Await Until Needed
impact: HIGH
impactDescription: avoids blocking unused code paths
tags: async, await, conditional, optimization
---
## Defer Await Until Needed
Move `await` operations into the branches where they're actually used to avoid blocking code paths that don't need them.
**Incorrect (blocks both branches):**
```typescript
async function handleRequest(userId: string, skipProcessing: boolean) {
const userData = await fetchUserData(userId)
if (skipProcessing) {
// Returns immediately but still waited for userData
return { skipped: true }
}
// Only this branch uses userData
return processUserData(userData)
}
```
**Correct (only blocks when needed):**
```typescript
async function handleRequest(userId: string, skipProcessing: boolean) {
if (skipProcessing) {
// Returns immediately without waiting
return { skipped: true }
}
// Fetch only when needed
const userData = await fetchUserData(userId)
return processUserData(userData)
}
```
**Another example (early return optimization):**
```typescript
// Incorrect: always fetches permissions
async function updateResource(resourceId: string, userId: string) {
const permissions = await fetchPermissions(userId)
const resource = await getResource(resourceId)
if (!resource) {
return { error: 'Not found' }
}
if (!permissions.canEdit) {
return { error: 'Forbidden' }
}
return await updateResourceData(resource, permissions)
}
// Correct: fetches only when needed
async function updateResource(resourceId: string, userId: string) {
const resource = await getResource(resourceId)
if (!resource) {
return { error: 'Not found' }
}
const permissions = await fetchPermissions(userId)
if (!permissions.canEdit) {
return { error: 'Forbidden' }
}
return await updateResourceData(resource, permissions)
}
```
This optimization is especially valuable when the skipped branch is frequently taken, or when the deferred operation is expensive.
© tech-leads-club · MIT · tech-leads-club/agent-skills