0027 — Внешний UI/UX-агент и reference workspace¶

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

Контекст¶

Владельцу нужен отдельный удобный внешний интерфейс для постоянной работы с UI/UX-агентом. Агент должен понимать весь проект через developer documentation, получать одну явную задачу, создавать окна, таблицы, UI-kit и другие visual references и накапливать собственную память о системе.

Внешний агент не используется как Product-code executor. Решение 0031 сделало его завершённый result автоматически принятым точным visual reference; внутренняя команда переносит его в приложение как есть и отдельно продвигает runtime по DEV/STAGE/PROD.

Решение¶

После создания Docs-репозитория внешний UI/UX-агент получает доступ ко всему developer-сайту dev-doc.skuaro.top под действующей защитой сайта.
Единственная текущая задача хранится в docs/ui-agent/TASK.md.
Её состояниями управляет владелец или внутренний координатор: EMPTY → READY → AWAITING_OWNER_REVIEW; внешнему агенту запрещено изменять task state.
Постоянный master prompt хранится в prompts/08-external-ui-ux-agent.md.
Агент изучает developer docs, текущий brief, прошлые results и свою рабочую memory, затем сохраняет reference package в docs/ui-agent/results/<task-id>/revision-<task-revision>/; новая ревизия не перезаписывает прошлую.
Накопленный принятый визуальный контекст хранится в docs/ui-agent/memory/ACCEPTED.md; актуальные developer docs и текущий brief имеют приоритет над старой памятью. Каждый result предлагает только MEMORY_DELTA.
Завершение внешней задачи объявляет владелец. После этого весь result автоматически принят как точный visual reference; внутренняя команда переносит visual memory, создаёт отдельную Product implementation task и возвращает TASK.md к EMPTY.
Reference package, UI-kit board или standalone HTML/CSS не считаются Product-кодом, проверенной реализацией или deploy artifact.
Размещение внутренней реализации на тестовом сервере и дальнейшее продвижение в production остаются отдельными действиями по действующим project gates.

Причины¶

Один task-файл проще очереди и соответствует управлению владельцем вручную.
Полный developer-сайт даёт агенту достаточный контекст без пересказа проекта в каждом брифе.
Results и memory сохраняют визуальную преемственность между задачами.
Явное закрытие исключает повторный запуск уже завершённой ревизии и автоматически принимает её visual result по решению 0031.
Отделение reference от Product implementation сохраняет ответственность за code, data, permissions и runtime у внутренней команды.

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

Первоначальное требование сохранять TASK.md в EMPTY до создания и публикации SkuAro-Docs заменено решением 0028: до сайта разрешён явно перечисленный снимок product-репозитория.
Качество external reference зависит от актуальности developer docs и полноты brief, но не переоценивается внутренней UI-проверкой.
Внутренняя команда обязана отличать автоматически принятый visual result от реализованного Product behavior и проверяет только contracts, сборку и runtime.
Reference assets могут увеличивать Git-репозиторий; действующее правило 50 MiB на файл сохраняется.

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

Переход к автоматической очереди, предоставление внешнему агенту роли Product-code executor или перенос reference workspace в отдельный repository требует нового решения.