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

async-defer-await — правило для Claude Code: оптимизация await

Правило async-defer-await учит откладывать операции await только на те ветки кода, где они действительно нужны. Это избегает блокировки путей выполнения, которые могут вернуться раньше.

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

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

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

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

Все правила IDE по теме «Бэкенд и API» →
async-expert martinholovsky Скилл async-expert направляет агента при написании асинхронного кода на Python, JavaScript, C# и Rust с упором на TDD и защиту от выдуманных API. CX Codex +1 212установок async-components patterns.dev Скилл async-components учит агента загружать Vue-компоненты асинхронно через defineAsyncComponent(), чтобы не тянуть тяжёлые модалки и диалоги при старте. CX Codex +1 207установок async-parallel jarrodwatts Правило async-parallel для Claude Code запускает независимые асинхронные вызовы параллельно через Promise.all(), а не по очереди. Заменяет последовательные await в обработчиках. CX Codex +1 ★ 1 064звёзд репо csharp-async официальный github Скилл csharp-async для GitHub Copilot, который проверяет асинхронный код на C# и подсказывает, как привести его к принятым практикам. Включается при ревью и написании методов с Task и await. CX Codex +1 10 883установок unit-test-scheduled-async giuseppe-trisciuoglio Скилл unit-test-scheduled-async с готовыми шаблонами юнит-тестов для Spring-методов @Scheduled и @Async: JUnit 5, CompletableFuture, Awaitility, Mockito. CX Codex +1 3 900установок js-performance-patterns patterns.dev Скилл js-performance-patterns для Claude Code помогает устранять просадки скорости в горячих путях JavaScript: в циклах, обработчиках событий и операциях с DOM. CX Codex +1 716установок

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

Весь набор →
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звёзд репо server-after-nonblocking Правило server-after-nonblocking учит агента переносить логирование, аналитику и фоновые задачи в функцию after() из Next.js. Это убирает задержку при отправке ответа клиенту. CX Codex +1 ★ 7 191звёзд репо rerender-lazy-state-init Правило rerender-lazy-state-init напоминает передавать в useState функцию, если начальное значение требует дорогих вычислений. Это пригодится в React-компонентах с данными из хранилища или сложными структурами. 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звёзд репо server-cache-react Правило server-cache-react учит ассистента мемоизировать серверные запросы через React.cache() и избегать повторных обращений к базе данных. CX Codex +1 ★ 7 191звёзд репо architecture-avoid-boolean-props Правило architecture-avoid-boolean-props запрещает раздувать компоненты булевыми пропсами и предлагает собирать варианты через композицию. Пригодится при проектировании React-компонентов. CX Codex +1 ★ 7 191звёзд репо

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

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