Cursor AI Setup – Система субагентов для автоматизации разработки
Разработка с AI часто означает хаос: субагенты работают в фоне, теряется контекст, непонятно что происходит. Эта конфигурация решает проблему — все субагенты работают последовательно в одном чате, видишь каждый шаг, полный контроль.
Что это такое
Cursor AI Setup — готовая к использованию конфигурация Cursor IDE с системой AI-субагентов для автоматизации разработки. Просто скачай, скопируй в свой проект и получи полноценную систему оркестрации задач с автоматическими проверками, тестами и документацией.
Условия покупки
Покупка один раз — доступ навсегда
Разовая оплата, никаких подписок. Скачал и используешь во всех своих проектах.
Бесплатные обновления
Все новые версии, дополнительные субагенты и улучшения доступны бесплатно после покупки.
Для кого это
- Для индивидуальных разработчиков: автоматизируй рутину, фокусируйся на архитектуре
- Для команд: единые стандарты, автоматические проверки, документация из коробки
- Для любых проектов: фронтенд, бэкенд, full-stack – любой стек технологий
- Для любой документации: настраивается под docs/, ai_docs/, свою структуру
Что НЕ включено
Это универсальная конфигурация. Файлы НЕ содержат:
- Специфичные инструкции для конкретных фреймворков
- Готовые шаблоны компонентов
- Правила конкретного code style (добавь свои в rules/)
Это база, которую нужно дополнить инструкциями для твоего проекта.
Что включено
Спойлер: Что включено
Команды
Спойлер: Команды
Как это работает
Спойлер: Как это работает Как это работает
Простая задача: /implement
Когда нужно быстро создать компонент, функцию или эндпоинт:
Код:
/implement Создай React компонент Button с пропсами label и onClick
Автоматически происходит:
- Worker создает код + тесты
- Test-Runner запускает тесты и верифицирует
- Documenter создает документацию
Результат: готовый компонент с тестами и документацией за минуты.
Сложная задача: /orchestrate
Когда нужна полная фича с планированием и автоматическими проверками:
Код:
/orchestrate Добавь систему аутентификации с email/password и OAuth
Автоматически происходит:
Фаза 1: Планирование
- Planner разбивает на задачи (AUTH-001: модели, AUTH-002: middleware, AUTH-003: endpoints…)
- Сохраняет план в workspace + (опционально) в документацию
Фаза 2: Выполнение — для каждой задачи:
- Worker реализует код
- Test-Runner запускает тесты
- Если тесты падают → Debugger исправляет (макс 3 попытки)
- Review проверяет качество кода
- Если найдены проблемы → Debugger исправляет
Фаза 3: Финализация
- Documenter создает итоговый отчет
Результат: полная фича с автоматическими фиксами, проверками и документацией.
Безопасный рефакторинг: /refactor
Когда код работает, но плохо организован:
Код:
/refactor Улучши структуру src/services/payment-processor.ts
Автоматически происходит:
- Senior-Reviewer находит code smells и цели рефакторинга
- Refactor применяет изменения (без смены поведения)
- Test-Runner верифицирует что ничего не сломалось
- Если тесты падают → Debugger исправляет
- Documenter создает отчет об изменениях
Важно: тесты должны существовать до рефакторинга. Если нет — сначала /implement для добавления тестов.
Проверка перед коммитом: /review
Код:
/review src/components/Form/
По умолчанию проверяет staged изменения (git diff —staged). Для нестрогих находок — спрашивает, фиксировать ли.
- Reviewer проверяет staged-изменения или указанные файлы
- Если критичные issues → Debugger автофикс (только с подтверждения)
- Test-Runner верификация после фиксов
Полный health check: /audit
Код:
/audit
Автоматически происходит:
- Senior-Reviewer — архитектура (SOLID, паттерны, зависимости)
- Security-Auditor — безопасность (OWASP Top 10, секреты, auth)
- Reviewer — качество кода (DRY, сложность, долг)
- Documenter — consolidated report + health score (0–10)
- (опционально) — автофикс критичных issues после подтверждения
Когда использовать: перед мажорным релизом, при онбординге в новый кодбейс, периодический health check.
AI-субагенты
Все субагенты можно использовать как автоматически (через workflows), так и вручную для точечных задач.
Спойлер: AI-субагенты
Skills – Переиспользуемые модули
Агенты используют skills для выполнения сложных задач:
Спойлер: Skills – Переиспользуемые модули
Rules – Универсальные правила
Правила применяются ко всем субагентам:
Спойлер: Rules – Универсальные правила
Workspace & Документация
Спойлер: Workspace & Документация Двухуровневая система
Workspace (Временный) — .cursor/workspace/
- Метаданные оркестрации (ID, статус, прогресс)
- Статусы задач
- Автоочистка через N дней
- ❌ НЕ коммитить в git
Документация (Постоянная) — конфигурируемые пути
- Планы, отчеты, ADR
- Финальная документация фич
- ✅ Коммитится в git
Нет дублирования, параллельные оркестрации без конфликтов, восстановление после сбоя.
Настройка под свой проект
Спойлер: Настройка под свой проект 1. Конфигурация документации Спойлер: Настройка под свой проект Редактируй .cursor/config.json:
Код:
{ "documentation": { "paths": { "root": "docs", "plans": "docs/plans", "reports": "docs/reports", "issues": "docs/issues" }, "enabled": { "plans": true, "reports": true, "issues": false } } }
Используешь docs/ вместо ai_docs/? Измени "root": "docs". Не нужны отчеты? Установи "reports": false.
2. Настройка агентов под проект
В configure-agents.md — готовые промпты для автонастройки агентов. Скопируй нужный промпт в чат Cursor, и агент сам просканирует проект и обновит файлы:
- test-runner — найдет команды тестов, линтера, typecheck и заменит дженерик-примеры на реальные команды
- test-writer — определит фреймворк, соглашения по именованию и структуру тестов
3. .gitignore
.cursor/workspace/
Структура конфигурации
Код:
.cursor/ ├── agents/ # 10 специализированных субагентов │ ├── worker.md # Создание кода │ ├── planner.md # Планирование задач │ ├── test-runner.md # Тестирование │ ├── test-writer.md # Написание тестов │ ├── debugger.md # Исправление ошибок │ ├── reviewer.md # Code review │ ├── documenter.md # Документация │ ├── refactor.md # Рефакторинг │ ├── security-auditor.md # Аудит безопасности │ └── senior-reviewer.md # Архитектурный review │ ├── commands/ # 5 автоматических workflows │ ├── implement.md # /implement │ ├── orchestrate.md # /orchestrate │ ├── refactor.md # /refactor │ ├── review.md # /review │ └── audit.md # /audit │ ├── skills/ # 11 переиспользуемых модулей │ ├── simple-workflow/ │ ├── orchestration/ │ ├── refactor-workflow/ │ ├── review-workflow/ │ ├── audit-workflow/ │ ├── task-management/ │ ├── docs/ │ ├── git-helper/ │ ├── security-guidelines/ │ ├── architecture-principles/ │ └── code-quality-standards/ │ ├── rules/ # 5 универсальных правил │ ├── commit-messages.md │ ├── git-workflow.md │ ├── testing.md │ ├── documentation.md │ └── security.md │ ├── config.json # Конфигурация (настрой под проект!) ├── hooks.json # Хуки (опционально) └── workspace/ # Временные данные (не коммитить)
Примеры использования
Спойлер: Примеры использования Создание компонента Спойлер: Примеры использования Код:
/implement Создай компонент Card в src/components/Card.tsx
Результат: компонент + тесты + документация
Фича с нуля до production
Код:
/orchestrate Добавь систему платежей через Stripe
Результат: план из задач → автоматическая реализация → тесты → фиксы → code review → документация
С файлом задач
Код:
/orchestrate @TODO.md
Planner использует твой файл, обновляет статусы задач (⏳→→✅) прямо в нем.
Рефакторинг
Код:
/refactor Улучши структуру src/services/payment-processor.ts /test-runner # Проверь что ничего не сломалось
Проверка перед коммитом
Код:
/review src/components/Form/
Аудит безопасности
Код:
/security-auditor Проверь auth endpoints в src/api/auth/
Быстрый фикс без документации
Код:
/worker Исправь баг в validateEmail в utils/validation.ts /test-runner
Архитектурный обзор
Код:
/senior-review Оцени дизайн кеширования в @CACHE-DESIGN.md
Комбинирование субагентов
Код:
# Безопасный рефакторинг вручную /refactor src/payment/processor.ts /test-runner /security-auditor src/payment/
Hooks – Автоматизация по событиям
Опционально можно настроить хуки для автоматизации:
- afterFileEdit – действия после изменения файла (auto-format)
- subagentStop – действия после завершения субагента (lint-fix, тесты)
Подробнее в HOOKS.md с AI-промптами для создания хуков.
Установка
После скачивания:
- Скопируй папку .cursor/ в корень проекта
- Открой .cursor/config.json – настрой пути документации
- Настрой агентов под проект — используй промпты из configure-agents.md
- Добавь .cursor/workspace/ в .gitignore
- Готово! Используй команды /implement, /orchestrate, /refactor, /review, /audit
⚠️ Папка .cursor/ скрытая. На macOS: Cmd + Shift + . в Finder. На Windows: Проводник → Вид → Показать → Скрытые элементы. В VS Code/Cursor файлы видны в боковой панели.Нажмите, чтобы раскрыть…
Философия
Видимость – все субагенты работают в одном чате, видишь каждый шаг
Контроль – можешь остановить, скорректировать или продолжить вручную
Гибкость – используй workflows для автоматизации или субагентов напрямую
Универсальность – работает с любым стеком и структурой документации
Расширяемость – добавляй своих субагентов, skills, правила
Как использовать
Скачай конфигурацию, скопируй в свой проект, настрой пути в config.json и агентов через configure-agents.md – и начни автоматизировать разработку с первой команды.
Продажник