К основному содержанию
правило CX Codex

backend — правило для Claude Code: что делает и как установить

Задаёт стандарты чистой архитектуры backend API с разделением на роутер, сервис и репозиторий. Без логики в контроллерах.

MIT ★ 1 472 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает 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-agent

2Вручную: положить файлы

.claude/rules/backend.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: 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

Похожие правила IDE

Все правила IDE по теме «Бэкенд и API» →
go-backend-clean-architecture rebyteai-template Скилл go-backend-clean-architecture разворачивает в проекте шаблон Go-бэкенда на Gin с MongoDB, JWT-авторизацией и слоями Clean Architecture — от клонирования до запуска. CX Codex +1 105установок backend-development MoizIbnYousaf Скилл backend-development для Claude Code и Codex по проектированию REST API, схем баз данных и микросервисной архитектуры. Агент держится одних конвенций при генерации бэкенда. CX Codex +1 876установок python-backend jiatastic Скилл python-backend для Claude Code и других агентов: готовые паттерны FastAPI, async SQLAlchemy, JWT/OAuth2, кэш и лимиты через Upstash. Держит агента в рамках при написании API. CX Codex +1 2 200установок api-gateway-backend-security-and-rate-limiting официальный google Скилл api-gateway-backend-security-and-rate-limiting для Claude Code, Gemini CLI и Codex настраивает аутентификацию клиентов и бэкенда, а также квоты запросов в Google Cloud API Gateway, включая шлюзы с MCP. CX Codex +1 360установок go-backend-microservices Mindrally Скилл go-backend-microservices для Claude Code задаёт стандарты разработки микросервисов на Go: чистая архитектура, OpenTelemetry и структурированное логирование. CX Codex +1 877установок backend-development-security-auditor Seth Hobson Субагент backend-development-security-auditor проверяет бэкенд и архитектуру на уязвимости OWASP Top 10, ошибки аутентификации и утечки данных прямо во время разработки фич. CX Codex ★ 42 780звёзд репо

Из того же набора69

Весь набор →
frontend-engineer Субагент frontend-engineer для вёрстки и фронтенд-разработки на React, Next.js, Angular и TypeScript. Создаёт компоненты, настраивает стили в TailwindCSS v4 и соблюдает правила архитектуры FSD-lite. CX Codex ★ 1 472звёзд репо qa-reviewer Субагент qa-reviewer автоматически проверяет код на уязвимости OWASP, проблемы производительности, доступность и качество. Запускается перед принятием изменений и выдаёт отчёт с рекомендациями по исправлению. CX Codex ★ 1 472звёзд репо mobile-engineer Субагент mobile-engineer создаёт мобильные приложения на Flutter, React Native, Swift и Kotlin с соблюдением принципов чистой архитектуры. CX Codex ★ 1 472звёзд репо backend-engineer backend-engineer — субагент для Claude Code, который выполняет задачи по API, аутентификации и миграциям БД. Он подключается к такой работе по запросу. CX Codex ★ 1 472звёзд репо market Правило market задаёт порядок исследования рынка через движок last30days: от проверки запроса до сохранения отчёта. Запускается на задачах о трендах, конкурентах и поиске рыночных возможностей. CX Codex +1 ★ 1 472звёзд репо refactor-engineer Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами. CX Codex ★ 1 472звёзд репо pm-planner Субагент pm-planner роли Product Manager для Claude Code и Codex. Разбирает требования, формирует API-контракты и декомпозирует фичи на параллельные задачи. CX Codex ★ 1 472звёзд репо oma-bootstrap Скилл oma-bootstrap проверяет, готов ли oma к задаче: CLI, нужные провайдеры и состояние проекта. Запускается перед скиллом или рабочим процессом, которому нужна команда oma. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой