advanced-init-once — правило для Claude Code: суть и установка
Правило advanced-init-once запрещает запускать глобальную инициализацию приложения в useEffect([]) компонентов и предлагает использовать флаг на уровне модуля или код в точке входа.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/advanced-init-once.mdЧто делает advanced-init-once
Правило запрещает размещать однократную инициализацию всего приложения внутри хука useEffect([]) в React-компонентах. При перемонтировании компонента эффекты запускаются заново, а в режиме разработки код выполняется дважды.
Вместо этого инструкция требует переносить запуск на верхний уровень входного модуля либо защищать вызов булевым флагом на уровне модуля. Такой подход исключает повторную загрузку данных из хранилища и повторные проверки токенов авторизации.
В dev-режиме React без модульного флага эффект неизбежно отработает два раза.
Какие задачи решает
- предотвратить повторный запуск стартовой логики при перемонтировании компонентов
- убрать двойное выполнение проверок авторизации в режиме разработки
- вынести инициализацию приложения на уровень входного модуля
- защитить хук
useEffectмодульным флагомdidInit
Примеры запросов агенту
- Проверь инициализацию приложения в компоненте авторизации и устрани повторные вызовы
- Перенеси стартовую загрузку данных из
useEffectна уровень входного модуля - Добавь защиту от повторного монтирования для вызова
checkAuthToken()
Как установить advanced-init-once
Вручную: положить файлы
.claude/rules/advanced-init-once.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/advanced-init-once.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/advanced-init-once.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/advanced-init-once.mdВручную: положить файлы
.clinerules/advanced-init-once.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об advanced-init-once
Как установить advanced-init-once в Claude Code?
Сохраните правило в файл .claude/rules/advanced-init-once.md в корне вашего проекта.
Зачем нужно правило advanced-init-once?
Оно не даёт агенту помещать глобальную инициализацию приложения в useEffect с пустым массивом зависимостей. Это исключает дублирование сетевых запросов и проверок токенов при повторном монтировании.
Как правило предлагает организовать инициализацию вместо useEffect?
Инструкция рекомендует выносить вызовы на верхний уровень входного модуля либо защищать их флагом didInit на уровне модуля.
Исходный текст
advanced-init-once.md · MIT
---
title: Initialize App Once, Not Per Mount
impact: LOW-MEDIUM
impactDescription: avoids duplicate init in development
tags: initialization, useEffect, app-startup, side-effects
---
## Initialize App Once, Not Per Mount
Do not put app-wide initialization that must run once per app load inside `useEffect([])` of a component. Components can remount and effects will re-run. Use a module-level guard or top-level init in the entry module instead.
**Incorrect (runs twice in dev, re-runs on remount):**
```tsx
function Comp() {
useEffect(() => {
loadFromStorage()
checkAuthToken()
}, [])
// ...
}
```
**Correct (once per app load):**
```tsx
let didInit = false
function Comp() {
useEffect(() => {
if (didInit) return
didInit = true
loadFromStorage()
checkAuthToken()
}, [])
// ...
}
```
Reference: [Initializing the application](https://react.dev/learn/you-might-not-need-an-effect#initializing-the-application)
© tech-leads-club · MIT · tech-leads-club/agent-skills