# typescript-nestjs-best-practices-cursorrules-promp

Правило typescript-nestjs-best-practices-cursorrules-promp для TypeScript-проектов на NestJS: модульная архитектура, SOLID, чистый код и тестирование по Arrange-Act-Assert.

- правило · `type=rule` · Cursor, Claude Code, Codex, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 41178 у репозитория
- Автор: PatrickJS
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/PatrickJS/awesome-cursorrules/tree/HEAD/rules/typescript-nestjs-best-practices-cursorrules-promp.mdc
- Обновлён: 2026-05-30
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/typescript-nestjs-best-practices-cursorrules-promp

## Что делает

Правило задаёт стиль кода для TypeScript и паттерны NestJS: явные типы для переменных и функций, отказ от `any`, PascalCase для классов, camelCase для функций и переменных, kebab-case для файлов. Функции короткие — до 20 строк, одна задача, начинаются с глагола; для boolean используется `isX`, `hasX`, `canX`. В NestJS требует модульную структуру — один модуль на домен, контроллер на маршрут, DTOs с `class-validator`, бизнес-логика в сервисах.

Тестирование по Arrange-Act-Assert для unit-тестов, Given-When-Then для acceptance-тестов, Jest из коробки. Для каждого контроллера и сервиса свой набор тестов, плюс end-to-end на модуль. Классы следуют SOLID, композиция предпочтительнее наследования, интерфейсы для контрактов. Исключения только для неожиданных ошибок; если перехватываешь — добавляешь контекст или исправляешь проблему, иначе глобальный обработчик.

## Установка

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

**Вручную: положить файлы**
- Файл: `.cursor/rules/typescript-nestjs-best-practices-cursorrules-promp.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/typescript-nestjs-best-practices-cursorrules-promp.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/typescript-nestjs-best-practices-cursorrules-promp.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/typescript-nestjs-best-practices-cursorrules-promp.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/typescript-nestjs-best-practices-cursorrules-promp.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PatrickJS/awesome-cursorrules/tree/HEAD/rules/typescript-nestjs-best-practices-cursorrules-promp.mdc

## Когда брать
- задать стандарты именования и типизации для TypeScript-проекта
- структурировать NestJS-приложение по модулям и контроллерам
- написать короткие функции с единственной задачей и явным типом
- организовать тестирование с Jest и покрыть контроллеры и сервисы
- применить SOLID и паттерны валидации через DTOs

## Примеры запросов агенту
- Создай модуль для пользователей с контроллером, сервисом и DTO для регистрации
- Напиши unit-тест для метода `findById` в `UsersService` по Arrange-Act-Assert
- Рефактори эту функцию — сократи до 20 строк и уберите вложенные блоки

## Похожие
- [nestjs-clean-typescript](https://affpapa.org/nevibecode/skills/nestjs-clean-typescript.md) — скилл · 998 установок
- [nestjs-testing](https://affpapa.org/nevibecode/rules/nestjs-testing.md) — правило · ★ 372 у репозитория
- [nestjs-testing-expert](https://affpapa.org/nevibecode/agents/nestjs-testing-expert.md) — субагент · ★ 372 у репозитория
- [nestjs-oop-design-patterns](https://affpapa.org/nevibecode/skills/nestjs-oop-design-patterns.md) — скилл · 560 установок
- [nestjs-expert](https://affpapa.org/nevibecode/agents/carlrannaberg-nestjs-expert.md) — субагент · ★ 763 у репозитория
- [nestjs-professional-software-engineering](https://affpapa.org/nevibecode/skills/nestjs-professional-software-engineering.md) — скилл · 556 установок

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

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

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