Ivan Fontosh
38 lines
3.1 KiB
Plaintext
38 lines
3.1 KiB
Plaintext
---
|
|
description: Базовые стандарты для агентной frontend-разработки
|
|
alwaysApply: true
|
|
---
|
|
|
|
# Базовые правила frontend-агента
|
|
|
|
## Миссия
|
|
|
|
Создавать поддерживаемые frontend-функции с предсказуемым поведением, явными предположениями и проверяемым результатом.
|
|
|
|
## Рабочий процесс
|
|
|
|
- Начинай с уточнения цели, ограничений и ожидаемого влияния на UX.
|
|
- Предпочитай небольшие инкрементальные изменения вместо широких переписываний.
|
|
- Сохраняй действующие конвенции проекта, если нет явной причины их менять.
|
|
- После существенных правок выполняй релевантные проверки и фиксируй результаты.
|
|
|
|
## Качество кода
|
|
|
|
- Ставь читаемость и явные имена выше «умных» сокращений.
|
|
- Держи компоненты сфокусированными: одна четкая ответственность на компонент/модуль.
|
|
- Выноси повторяющуюся логику в хуки или утилиты, когда появляется дублирование; не размножай копии форм и модалок, если достаточно одной параметризованной реализации.
|
|
- Не добавляй мертвый код, неиспользуемые экспорты и закомментированные блоки.
|
|
|
|
## Надежность и совместимость
|
|
|
|
- Не ломай публичные API компонентов без документирования шагов миграции.
|
|
- Сохраняй базовую доступность (labels, клавиатурная навигация, семантические элементы).
|
|
- Обрабатывай состояния загрузки, пустого результата и ошибок в асинхронных UI-путях; подтверждения и модалки — через UI приложения, не через нативные диалоги браузера (в Electron renderer — аналогично: внутренние модалки приложения).
|
|
- Добавляй или обновляй тесты при изменении поведения критичных пользовательских сценариев.
|
|
|
|
## Взаимодействие с агентом
|
|
|
|
- Явно указывай, что изменено, зачем это изменено и как это проверить.
|
|
- Прямо фиксируй риски и компромиссы при нетривиальных решениях.
|
|
- Если требования неоднозначны, остановись и уточни перед реализацией предположений.
|