# ai-agent-specialist

Правило задаёт стандарты для TypeScript, React и Node.js: архитектура, обработка ошибок, тесты, безопасность и Git. Подходит для проектов, где важны объяснения WHY.

- правило · `type=rule` · Cursor · ★ 41024
- Автор: PatrickJS
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/PatrickJS/awesome-cursorrules/tree/HEAD/rules/ai-agent-specialist.mdc
- Обновлён: 2026-05-30
- HTML: https://affpapa.org/nevibecode/rules/ai-agent-specialist

## Что делает

Правило настраивает работу Cursor с TypeScript, React и Node.js. Оно требует строгой типизации без `any`, ограничивает функции двадцатью строками, задаёт соглашения для имён и советует использовать интерфейсы для объектов. Каждое требование сопровождается объяснением WHY.

В архитектуре заданы Clean Architecture, инверсия зависимостей и паттерн репозитория. Для состояния предлагаются React Query и Zustand, а Redux запрещён. Правило также описывает `AppError`, `Result`, Winston, валидацию через Zod, rate limiting, helmet и требования к тестам: 80% покрытия для unit-тестов и 100% для критических путей. Правило применяется к `**/*`, но `alwaysApply` имеет значение `false`.

В Git-части заданы лимит в 400 строк на PR и Conventional Commits с типами `feat`, `fix`, `refactor`, `test`, `docs`. Проекту с Redux придётся учитывать прямое требование отказаться от него.

## Установка

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

**Вручную: положить файлы**
- Файл: `.cursor/rules/ai-agent-specialist.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

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

### Codex

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

### GitHub Copilot

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

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/ai-agent-specialist.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/ai-agent-specialist.md`

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

## Когда брать
- задать строгие правила для TypeScript-кода
- разделить доменную логику и доступ к данным
- организовать обработку ожидаемых и исключительных ошибок
- проверить входные данные через схемы Zod
- сформировать требования к тестам и pull request

## Примеры запросов агенту
- Проверь этот модуль на соответствие правилам TypeScript и вынеси функции длиннее двадцати строк.
- Спроектируй обработку данных через Clean Architecture и паттерн репозитория.
- Добавь валидацию API-входа с помощью Zod и не записывай токены в логи.

## Похожие
- [winui3](https://affpapa.org/nevibecode/rules/winui3.md) — правило · ★ 40451
- [vue](https://affpapa.org/nevibecode/rules/vue.md) — правило · ★ 40451
- [tanstack-start-shadcn-tailwind](https://affpapa.org/nevibecode/rules/tanstack-start-shadcn-tailwind.md) — правило · ★ 40451
- [tailwind-v4-vite](https://affpapa.org/nevibecode/rules/tailwind-v4-vite.md) — правило · ★ 40451
- [svelte](https://affpapa.org/nevibecode/rules/svelte.md) — правило · ★ 40451
- [power-bi-custom-visuals-development](https://affpapa.org/nevibecode/rules/power-bi-custom-visuals-development.md) — правило · ★ 40451

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

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

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