async-dependencies — правило для Claude Code
Правило async-dependencies направляет Claude Code на параллельный запуск асинхронных операций с частичными зависимостями через better-all или цепочки промисов вместо блокирующего Promise.all.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/async-dependencies.mdЧто делает async-dependencies
Обычный Promise.all часто блокирует независимые вызовы. Например, получение профиля ждёт загрузку конфигурации, хотя зависит только от идентификатора пользователя. Из-за этого приложение теряет время на пустом ожидании. Правило учит агента находить частичные зависимости и запускать каждую операцию в самый ранний момент.
В инструкциях предложены два решения. Основной вариант использует библиотеку better-all, в которой функции обращаются к соседям через this.$.user. Альтернативный способ связывает промисы через .then() до передачи массива в Promise.all. Автор заявляет ускорение выполнения в 2-10× раз.
Без библиотеки better-all придётся вручную связывать цепочки промисов, чтобы не раздувать зависимости проекта.
Какие задачи решает
- устранить лишние задержки при ожидании несвязанных промисов
- настроить запуск асинхронных задач в самый ранний момент
- внедрить вызовы better-all в код на TypeScript
- построить граф зависимостей на промисах без сторонних библиотек
Примеры запросов агенту
- Оптимизируй загрузку профиля и конфига, чтобы независимые запросы шли параллельно.
- Перепиши эти функции через better-all для ускорения загрузки данных.
- Сделай параллельный запуск зависимых промисов без внешних библиотек.
Как установить async-dependencies
Вручную: положить файлы
.claude/rules/async-dependencies.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/async-dependencies.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/async-dependencies.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/async-dependencies.mdВручную: положить файлы
.clinerules/async-dependencies.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об async-dependencies
Как установить async-dependencies в Claude Code?
Создайте файл .claude/rules/async-dependencies.md в корне репозитория и сохраните в него текст правила.
Что делает правило async-dependencies?
Оно обучает Claude Code выстраивать асинхронные цепочки по графу зависимостей, предотвращая задержки от неэффективных вызовов Promise.all.
Обязательно ли устанавливать библиотеку better-all?
Нет, правило также содержит паттерн на стандартных промисах с предварительным созданием цепочек через .then().
Исходный текст
async-dependencies.md · MIT
---
title: Dependency-Based Parallelization
impact: CRITICAL
impactDescription: 2-10× improvement
tags: async, parallelization, dependencies, better-all
---
## Dependency-Based Parallelization
For operations with partial dependencies, use `better-all` to maximize parallelism. It automatically starts each task at the earliest possible moment.
**Incorrect (profile waits for config unnecessarily):**
```typescript
const [user, config] = await Promise.all([
fetchUser(),
fetchConfig()
])
const profile = await fetchProfile(user.id)
```
**Correct (config and profile run in parallel):**
```typescript
import { all } from 'better-all'
const { user, config, profile } = await all({
async user() { return fetchUser() },
async config() { return fetchConfig() },
async profile() {
return fetchProfile((await this.$.user).id)
}
})
```
**Alternative without extra dependencies:**
We can also create all the promises first, and do `Promise.all()` at the end.
```typescript
const userPromise = fetchUser()
const profilePromise = userPromise.then(user => fetchProfile(user.id))
const [user, config, profile] = await Promise.all([
userPromise,
fetchConfig(),
profilePromise
])
```
Reference: [https://github.com/shuding/better-all](https://github.com/shuding/better-all)
© tech-leads-club · MIT · tech-leads-club/agent-skills