backend-dev-guidelines
Настройка бэкенда для production-сервисов с учетом архитектурных ограничений. Применяется при работе с маршрутами, контроллерами, сервисами, репозиториями, middleware Express и доступом к базе данных через Prisma.
AIsickn33
official
Разработка
★ 47.3k
Что делает навык
Настройка бэкенда для production-сервисов на Node.js, Express и TypeScript с соблюдением строгой архитектурной дисциплины. Skill обеспечивает предсказуемость, наблюдаемость и поддерживаемость систем через слоистую архитектуру, централизованную конфигурацию и обязательное тестирование.
Когда применять
- Разработка новых маршрутов, контроллеров, сервисов и репозиториев в рамках микросервисной архитектуры.
- Создание или модификация Express middleware и настройка доступа к базе данных через Prisma.
- Проведение рефакторинга или миграции бэкенд-кода с целью устранения антипаттернов и улучшения тестируемости.
- Настройка валидации входных данных с использованием Zod и интеграция отслеживания ошибок через Sentry.
Как работает
- Оценить BFRI (Backend Feasibility & Risk Index) для определения допустимости реализации и необходимости дополнительных тестов или мониторинга.
- Соблюдать обязательную слоистую архитектуру: Routes → Controllers → Services → Repositories → Database, без пропуска слоев.
- Использовать BaseController для обработки ошибок и форматирования ответов, а также asyncErrorWrapper для всех асинхронных обработчиков.
- Применять централизованную конфигурацию через unifiedConfig и валидировать все внешние входные данные с помощью Zod.
- Записывать все ошибки в Sentry, избегая console.log и молчаливых сбоев, и обеспечивать покрытие кода unit- и integration-тестами.
Примеры запросов агенту
Реализуй новый эндпоинт для создания пользователя, соблюдая архитектуру routes → controllers → services → repositories.
Проведи рефакторинг существующего контроллера: вынеси бизнес-логику в сервис, добавь валидацию Zod и обработку ошибок через Sentry.
Настрой структуру проекта src/ для нового микросервиса с учетом требований к именам файлов и директорий.
Что понадобится
- Среда Node.js с использованием Express, TypeScript и Prisma.
- Интеграция с Sentry для отслеживания ошибок и производительности.
- Библиотека Zod для валидации входных данных.
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «sickn33-backend-dev-guidelines» из репозитория:
# https://github.com/sickn33/agentic-awesome-skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r sickn33-backend-dev-guidelines/ ~/.claude/skills/sickn33-backend-dev-guidelines/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.