0028 — Первая UI-reference задача до developer-сайта¶

Дата: 2026-08-26.
Статус: Принято пользователем.
Ответственный: владелец проекта.

Контекст¶

Решение 0027 первоначально связывало запуск внешней UI/UX-задачи с публикацией полного developer-сайта. Владелец решил не ждать создания SkuAro-Docs и поручил сразу передать внешнему агенту первую задачу: полностью пересобрать существующий UI в новом визуальном направлении по референсам, уже доступным агенту.

Решение¶

docs/ui-agent/TASK.md разрешено перевести в READY при developer_docs_url: NOT_DEPLOYED.
До публикации developer-сайта TASK.md обязан указывать точный product_context_revision и все обязательные пути product-репозитория в current_materials.
Если внешний агент не имеет доступа к обязательному материалу, он останавливает работу и возвращает конкретный blocker, а не восполняет продуктовый контекст догадками.
Референсы, уже находящиеся в рабочей области внешнего агента, разрешены как visual direction. Агент обязан перечислить их в result, указать использованные паттерны и не копировать чужие brand, claims, тексты или assets без отдельного решения о происхождении и license.
Первая задача охватывает новый дизайн всего фактически существующего UI, но не меняет маршруты, роли, permissions, продуктовые границы или реализованное поведение.
Result остаётся reference package. Product-код, реализация, тестовый сервер и production следуют только отдельными задачами и разрешениями.

Причины¶

Визуальную работу можно начать по текущему репозиторию без ожидания отдельного Docs-контура.
Явный список источников сохраняет проверяемость контекста и не превращает brief в свободное продуктовое проектирование.
Инвентаризация внешних референсов снижает риск неосознанного копирования.

Последствия¶

Первая задача может стартовать немедленно, а создание developer-сайта остаётся отдельным отложенным направлением.
Снимок product-репозитория может устареть; новая ревизия задачи обязана обновить product_context_revision и перечень материалов.
Внешнему агенту нужен фактический доступ ко всем путям из current_materials.
После появления developer-сайта следующие задачи используют его как основной источник полного контекста по решению 0027.

Откат или замена¶

Возврат к обязательному ожиданию developer-сайта или передача внешнему агенту Product-кода требует нового решения владельца.