---
description: Базовые стандарты для агентной frontend-разработки
alwaysApply: true
---

# Базовые правила frontend-агента

## Миссия

Создавать поддерживаемые frontend-функции с предсказуемым поведением, явными предположениями и проверяемым результатом.

## Рабочий процесс

- Начинай с уточнения цели, ограничений и ожидаемого влияния на UX.
- Предпочитай небольшие инкрементальные изменения вместо широких переписываний.
- Сохраняй действующие конвенции проекта, если нет явной причины их менять.
- После существенных правок выполняй релевантные проверки и фиксируй результаты.

## Качество кода

- Ставь читаемость и явные имена выше «умных» сокращений.
- Держи компоненты сфокусированными: одна четкая ответственность на компонент/модуль.
- Выноси повторяющуюся логику в хуки или утилиты, когда появляется дублирование; не размножай копии форм и модалок, если достаточно одной параметризованной реализации.
- Не добавляй мертвый код, неиспользуемые экспорты и закомментированные блоки.

## Надежность и совместимость

- Не ломай публичные API компонентов без документирования шагов миграции.
- Сохраняй базовую доступность (labels, клавиатурная навигация, семантические элементы).
- Обрабатывай состояния загрузки, пустого результата и ошибок в асинхронных UI-путях; подтверждения и модалки — через UI приложения, не через нативные диалоги браузера (в Electron renderer — аналогично: внутренние модалки приложения).
- Добавляй или обновляй тесты при изменении поведения критичных пользовательских сценариев.

## Взаимодействие с агентом

- Явно указывай, что изменено, зачем это изменено и как это проверить.
- Прямо фиксируй риски и компромиссы при нетривиальных решениях.
- Если требования неоднозначны, остановись и уточни перед реализацией предположений.