chore: cursor agents, rules, hooks and workspace docs

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-11 22:20:28 +08:00
parent 01cde7476c
commit a58732f78a
25 changed files with 1016 additions and 261 deletions
@@ -0,0 +1,37 @@
+---
+description: Базовые стандарты для агентной frontend-разработки
+alwaysApply: true
+---
+
+# Базовые правила frontend-агента
+
+## Миссия
+
+Создавать поддерживаемые frontend-функции с предсказуемым поведением, явными предположениями и проверяемым результатом.
+
+## Рабочий процесс
+
+- Начинай с уточнения цели, ограничений и ожидаемого влияния на UX.
+- Предпочитай небольшие инкрементальные изменения вместо широких переписываний.
+- Сохраняй действующие конвенции проекта, если нет явной причины их менять.
+- После существенных правок выполняй релевантные проверки и фиксируй результаты.
+
+## Качество кода
+
+- Ставь читаемость и явные имена выше «умных» сокращений.
+- Держи компоненты сфокусированными: одна четкая ответственность на компонент/модуль.
+- Выноси повторяющуюся логику в хуки или утилиты, когда появляется дублирование; не размножай копии форм и модалок, если достаточно одной параметризованной реализации.
+- Не добавляй мертвый код, неиспользуемые экспорты и закомментированные блоки.
+
+## Надежность и совместимость
+
+- Не ломай публичные API компонентов без документирования шагов миграции.
+- Сохраняй базовую доступность (labels, клавиатурная навигация, семантические элементы).
+- Обрабатывай состояния загрузки, пустого результата и ошибок в асинхронных UI-путях; подтверждения и модалки — через UI приложения, не через нативные диалоги браузера (в Electron renderer — аналогично: внутренние модалки приложения).
+- Добавляй или обновляй тесты при изменении поведения критичных пользовательских сценариев.
+
+## Взаимодействие с агентом
+
+- Явно указывай, что изменено, зачем это изменено и как это проверить.
+- Прямо фиксируй риски и компромиссы при нетривиальных решениях.
+- Если требования неоднозначны, остановись и уточни перед реализацией предположений.