js-index-maps — правило для Claude Code: что делает и как установить
Правило js-index-maps заменяет повторные .find() по одному ключу на индекс Map. Оно пригодится при частых поисках в массивах.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/js-index-maps.mdЧто делает js-index-maps
Правило предлагает строить Map один раз, когда код много раз ищет элементы по одному ключу. Например, пользователей можно проиндексировать по id, а затем получать их для заказов через get() вместо повторного прохода массива через .find().
Построение индекса занимает O(n), последующие обращения к Map — O(1). Для 1000 заказов и 1000 пользователей это меняет 1M операций на 2K. Если оставить .find() внутри обработки заказов, каждая операция поиска остаётся O(n).
Какие задачи решает
- заменить повторные
.find()по ключу - проиндексировать пользователей по
id - сократить число операций при обработке заказов
- найти линейный поиск внутри цикла
Примеры запросов агенту
- Проверь код обработки заказов и замени повторные
.find()поuserIdнаMap. - Проиндексируй
usersпоid, затем перепиши поиск пользователя черезget(). - Найди в проекте повторные поиски по одному ключу и предложи рефакторинг с индексом.
Как установить js-index-maps
Вручную: положить файлы
.claude/rules/js-index-maps.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/js-index-maps.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/js-index-maps.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/js-index-maps.mdВручную: положить файлы
.clinerules/js-index-maps.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о js-index-maps
Как установить js-index-maps в Claude Code?
Поместите правило в файл .claude/rules/js-index-maps.md.
Что делает js-index-maps?
Правило подсказывает заменять повторные вызовы .find() по одному ключу на один индекс Map и обращения через get().
Почему Map лучше повторного .find() в этом случае?
Индекс строится за O(n), а отдельные поиски выполняются за O(1). Для 1000 заказов и 1000 пользователей пример сокращает 1M операций до 2K.
Исходный текст
js-index-maps.md · MIT
---
title: Build Index Maps for Repeated Lookups
impact: LOW-MEDIUM
impactDescription: 1M ops to 2K ops
tags: javascript, map, indexing, optimization, performance
---
## Build Index Maps for Repeated Lookups
Multiple `.find()` calls by the same key should use a Map.
**Incorrect (O(n) per lookup):**
```typescript
function processOrders(orders: Order[], users: User[]) {
return orders.map(order => ({
...order,
user: users.find(u => u.id === order.userId)
}))
}
```
**Correct (O(1) per lookup):**
```typescript
function processOrders(orders: Order[], users: User[]) {
const userById = new Map(users.map(u => [u.id, u]))
return orders.map(order => ({
...order,
user: userById.get(order.userId)
}))
}
```
Build map once (O(n)), then all lookups are O(1).
For 1000 orders × 1000 users: 1M ops → 2K ops.
© tech-leads-club · MIT · tech-leads-club/agent-skills