index-sync — правило для Claude Code: синхронизация индекса
Правило index-sync напоминает обновлять машинный индекс, когда меняется guide/, и проверять ссылки на страницы. Пригодится в проекте, где индекс питает MCP-сервер и поиск.
CC-BY-SA-4.0 ★ 6 529 обновлён 2026-10-22
.claude/rules/index-sync.mdЧто делает index-sync
Когда в guide/ добавляют страницу, раздел, понятие или инструмент, правило требует отразить изменение в индексах. В machine-readable/reference.yaml добавляют ключ deep_dive со ссылкой на якорь; mcp-server/content/reference.yaml обновляют вручную. Для новой области верхнего уровня меняют llms-full.txt, а списки покрытия в двух файлах llms.txt сохраняют одинаковыми.
Проверки запускаются командами python3 scripts/check-index-coverage.py --check и python3 scripts/validate-reference-yaml.py --ci; они также входят в CI. Если меняли ключ deep_dive, в репозитории лендинга нужно выполнить pnpm build:search, иначе палитра поиска продолжит показывать старую запись. Хук .claude/hooks/index-sync-reminder.sh лишь предупреждает в конце хода: он не блокирует работу.
Какие задачи решает
- обновить индекс после добавления страницы в
guide/ - связать понятие с нужным якорем в справочнике
- проверить, что файлы справки доступны и ссылки работают
- напомнить об индексе, если менялась документация
Примеры запросов агенту
- Добавь страницу в
guide/и обнови связанные индексы по правилу. - Проверь якоря и покрытие после изменения справочника.
- Я изменил
deep_dive; подскажи, что обновить для палитры поиска.
Как установить index-sync
Вручную: положить файлы
.claude/rules/index-sync.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/index-sync.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/index-sync.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/index-sync.mdВручную: положить файлы
.clinerules/index-sync.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об index-sync
Как установить index-sync в Claude Code?
Помести файл правила по пути .claude/rules/index-sync.md.
Что делает правило index-sync?
Оно задаёт, какие машинные индексы обновлять при изменениях в guide/, и какие проверки запускать. Хук напоминает о синхронизации, но не останавливает работу.
Нужно ли пересобирать поиск после изменения deep_dive?
Да. Выполни pnpm build:search в репозитории лендинга, иначе палитра может показывать прежнюю запись.