# backend-dev-guidelines

Задаёт агенту роль senior-бэкендера: слоистая архитектура, Zod-валидация, DI и один источник конфига. Пригодится на Express и Prisma.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1800 установок · ★ 48508
- Автор: sickn33
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sickn33/agentic-awesome-skills/tree/HEAD/skills/backend-dev-guidelines/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/backend-dev-guidelines

## Что делает

Скилл включается, когда агент трогает роуты, контроллеры, сервисы, репозитории, middleware Express или доступ к базе через Prisma. Внутри — набор правил: роуты только маршрутизируют, контроллеры наследуют `BaseController`, сервисы держат бизнес-логику и получают зависимости через конструктор, Prisma живёт исключительно в репозиториях.

Перед работой над фичей скилл предлагает оценить её по шкале BFRI: архитектурное соответствие и тестируемость минус сложность логики, риск для данных и операционный риск. Формула даёт число от `-13` до `+7`, и автор оговаривает, что это повод для обсуждения, а не валидированная модель риска и не гейт для мержа. Конфиг берётся только из `unifiedConfig`, внешний ввод валидируется через Zod, ошибки ловятся в одной точке.

Это документация, а не готовый сервис: запускать нечего. Архитектура вашего репозитория, модель авторизации и версии зависимостей имеют приоритет над этими паттернами. Для Express 4 нужен `asyncErrorWrapper` — обёртка не подхватывает фоновые задачи, которые вы не вернули и не дождались.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sickn33/agentic-awesome-skills --skill backend-dev-guidelines -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/backend-dev-guidelines/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/backend-dev-guidelines/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sickn33/agentic-awesome-skills --skill backend-dev-guidelines -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/backend-dev-guidelines/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sickn33/agentic-awesome-skills --skill backend-dev-guidelines -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/backend-dev-guidelines/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sickn33/agentic-awesome-skills backend-dev-guidelines
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/backend-dev-guidelines/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sickn33/agentic-awesome-skills --skill backend-dev-guidelines -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/sickn33/agentic-awesome-skills --path skills/backend-dev-guidelines
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/backend-dev-guidelines/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add sickn33/agentic-awesome-skills --skill backend-dev-guidelines -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sickn33/agentic-awesome-skills/tree/HEAD/skills/backend-dev-guidelines/SKILL.md

## Когда брать
- разложить Express-приложение по слоям routes → controllers → services → repositories
- убрать запросы к Prisma прямо из контроллеров
- проверить фичу по шкале BFRI до начала кодинга
- закрыть все входные данные Zod-схемами
- вынести конфиг из `process.env` в `unifiedConfig`

## Примеры запросов агенту
- Добавь эндпоинт создания заказа по правилам backend-dev-guidelines
- Отрефактори `userController.ts` — Prisma должна уйти в репозиторий
- Оцени по BFRI, стоит ли тащить биллинг в текущий сервис

## Похожие
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [claude-api](https://affpapa.org/nevibecode/skills/claude-api.md) — скилл · 74198 установок
- [lark-im](https://affpapa.org/nevibecode/skills/lark-im.md) — скилл · 472900 установок
- [lark-event](https://affpapa.org/nevibecode/skills/lark-event.md) — скилл · 466800 установок
- [caveman-discover](https://affpapa.org/nevibecode/skills/caveman-discover.md) — скилл · 104400 установок
- [migration](https://affpapa.org/nevibecode/skills/migration.md) — скилл · 103900 установок

## Другие версии с тем же именем
- [backend-dev-guidelines · diet103](https://affpapa.org/nevibecode/skills/diet103-backend-dev-guidelines.md) — ★ 10039

Из того же набора: [sickn33/agentic-awesome-skills](https://affpapa.org/nevibecode/by/sickn33/agentic-awesome-skills.md) — 101 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md