FRONTEND.md

Этот файл задаёт стабильные ожидания по фронтенду, чтобы агенты не изобретали UI-паттерны непредсказуемо.

Принципы UI

• Оптимизируйте под ясность раньше, чем под новизну.
• Делайте потоки взаимодействия обнаруживаемыми и перезапускаемыми.
• Предпочитайте небольшое число переиспользуемых компонентов одноразовым вариантам.
• Проверки доступности — часть обычной верификации, а не финального полирования.

Ограничители

• Документируйте дизайн-систему или библиотеку компонентов в docs/references/.
• Фиксируйте ключевые состояния, видимые пользователю: пустое, загрузка, успех, ошибка, повтор.
• Сохраняйте согласованность копирайтинга, поведения клавиатуры и визуальной иерархии между потоками.
• Когда UI-баг исправлен, добавьте или обновите соответствующий шаг валидации.

Ожидания по верификации

• Захватывайте доказательства для критичных пользовательских сценариев.
• Записывайте шаги валидации в браузере или рантайме в соответствующий план.
• Если визуальные регрессии часты, стандартизируйте проверки скриншотов или DOM.