backend — правило для Claude Code: что делает и как установить
Задаёт стандарты чистой архитектуры backend API с разделением на роутер, сервис и репозиторий. Без логики в контроллерах.
MIT ★ 1 472 обновлён 2026-10-29
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agentЧто делает backend
Правило выстраивает разработку API по цепочке Router → Service → Repository → Models. Обработчики маршрутов только принимают HTTP-запрос и проверяют входные данные через библиотеку валидации. Вся бизнес-логика уходит в сервисы, а обращение к базе данных изолируется в репозиториях. Запросы к базе разрешены только параметризованные, интерполяция строк запрещена.
Для авторизации предписаны JWT и Argon2id (bcrypt оставлен для совместимости), а также ограничение частоты запросов на эндпоинтах входа. При интеграции сторонних API (OpenAI, Stripe) агент обязан писать две ветки: реальный сетевой вызов при наличии переменной в окружении и детерминированную локальную заглушку с комментарием // TODO(oma-deferred): integrate <vendor> when key is provisioned. Без такой заглушки код сломает локальный запуск, если ключа нет в окружении.
Какие задачи решает
- разделить бизнес-логику и обработку HTTP-запросов
- закрыть риск SQL-инъекций обязательной параметризацией
- настроить авторизацию на связке JWT и Argon2id
- добавить локальные заглушки для внешних API
Примеры запросов агенту
- Спроектируй эндпоинт оформления заказа по правилу чистой архитектуры
- Подключи сторонний платёжный шлюз с веткой для локальной работы без ключа
Как установить backend
1Через маркетплейс плагинов
/plugin marketplace add first-fluke/oh-my-agent/plugin install oma@oh-my-agent2Вручную: положить файлы
.claude/rules/backend.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/backend.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/backend.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/backend.mdВручную: положить файлы
.clinerules/backend.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о backend
Как установить backend в Claude Code?
Выполните команду /plugin marketplace add first-fluke/oh-my-agent, а затем /plugin install oma@oh-my-agent. Также можно вручную сохранить файл по пути .claude/rules/backend.md.
Что делает правило backend?
Оно предписывает ИИ-агенту разделять код на роутеры, сервисы и репозитории, типизировать сигнатуры и изолировать бизнес-логику от HTTP-слоя.
Как правило требует подключать внешние API?
Код должен содержать две ветки: реальный вызов по ключу из окружения и детерминированный фолбек с комментарием // TODO(oma-deferred): integrate <vendor> when key is provisioned.
Исходный текст
backend.md · MIT
--- description: Backend API coding standards with clean architecture (Router/Service/Repository pattern) globs: alwaysApply: false --- # Backend Coding Standards ## Core Rules 1. **Clean architecture**: router -> service -> repository -> models 2. **No business logic in route handlers** 3. **All inputs validated** with your stack's validation library 4. **Parameterized queries only** (never string interpolation) 5. **JWT + Argon2id for auth** (bcrypt acceptable for legacy compatibility); rate limit auth endpoints 6. **Async where supported**; type annotations on all signatures 7. **Custom exceptions** via centralized error module (not raw HTTP exceptions) 8. **Explicit ORM loading strategy**: do not rely on default relation loading when query shape matters 9. **Explicit transaction boundaries**: group one business operation into one request/service-scoped unit of work 10. **Safe ORM lifecycle**: do not share mutable ORM session/entity manager across concurrent work unless ORM explicitly supports it 11. **Config from environment, with graceful fallback**: DB URLs, API keys, secrets from env vars or secret managers, never hardcode. When integrating a third-party API (OpenAI, Anthropic, Stripe, etc.), write BOTH paths: (a) real call when `process.env.<KEY>` is present, (b) deterministic local fallback when absent. Mark the deferred branch with `// TODO(oma-deferred): integrate <vendor> when key is provisioned`. Shipping only the fallback (no env-conditional branch) leaves the spec unmet; shipping only the real call without fallback breaks demos when the key is missing. 12. **Stateless services**: no in-memory session or user state between requests — use external stores 13. **Backing services as resources**: DB, queue, cache are swappable resources connected via config ## Architecture ``` Router (HTTP) → Service (Business Logic) → Repository (Data Access) → Models ``` ## Principles - **DRY**: Business logic in Service, data access in Repository - **Single Responsibility**: Classes and functions should have one responsibility - **Dependency Inversion**: Use your framework's DI mechanism - **KISS**: Keep it simple and clear
© First Fluke · MIT · first-fluke/oh-my-agent