backend-node — правило для Claude Code: что делает и как установить
Правило backend-node для Claude Code содержит инструкции по работе с серверными скриптами Node.js и обработчиками хуков. Помогает сохранять совместимость API и целостность базы данных.
MIT ★ 1 198 обновлён 2026-10-23
.claude/rules/backend-node.mdЧто делает backend-node
Правило действует на файлы по маскам server/**/*.js и scripts/**/*.js. Оно запрещает ломать формат ответов API без прямого запроса от разработчика. При правках маршрутов агент обязан валидировать входные данные и возвращать структурированные ошибки.
Для обращений к базе данных предписано брать готовые шаблоны подготовленных запросов из server/db.js. Логика приёма хуков должна оставаться детерминированной и неблокирующей, с сохранением границ транзакций при обработке событий. Без проверки стейт-машин сессий и жизненного цикла агентов менять статусы нельзя.
Какие задачи решает
- сохранять обратную совместимость ответов API при доработке эндпоинтов
- валидировать параметры маршрутов и возвращать структурированные ошибки
- предотвращать блокировки при приёме входящих хуков
- удерживать границы транзакций и целостность данных в обработке событий
- соблюдать шаблон подготовленных запросов из
server/db.js
Примеры запросов агенту
- Добавь валидацию параметров в новый маршрут внутри
server/routes.js - Обнови логику приёма хуков в
scripts/ingest.jsбез блокировки цикла событий - Измени статус сессии агента и проверь переходы состояний жизненного цикла
Как установить backend-node
Вручную: положить файлы
.claude/rules/backend-node.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/backend-node.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/backend-node.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/backend-node.mdВручную: положить файлы
.clinerules/backend-node.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о backend-node
Как установить backend-node в Claude Code?
Сохраните файл правила по пути .claude/rules/backend-node.md в корне проекта. Claude Code подхватит его автоматически.
Для каких файлов срабатывает backend-node?
Инструкции активируются при работе с файлами по маскам server/**/*.js и scripts/**/*.js.
Что требует правило при работе с базой данных?
Оно предписывает использовать подготовленные запросы по образцу из server/db.js и сохранять границы транзакций.
Исходный текст
backend-node.md · MIT
--- paths: - "server/**/*.js" - "scripts/**/*.js" --- # Backend and Hook Rules - Keep API responses backward-compatible unless a breaking change is explicitly requested. - Maintain deterministic, non-blocking hook ingestion behavior. - Preserve transaction boundaries and data integrity in event processing logic. - For route changes, validate input thoroughly and return structured errors. - Prefer prepared-statement usage patterns already established in `server/db.js`. - If touching status transitions, verify session and agent lifecycle state machines still make sense.
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor