Task card: external UI reference workspace

Статус: ACCEPTED_FOR_HANDOFF.

Дата: 2026-08-26.

Цель

Создать простой интерфейс работы с внешним UI/UX-агентом: одна текущая MD-задача, полный developer-сайт как контекст, папки results/memory и внутренний переход от готового reference к Product implementation.

Scope

• master prompt внешнего UI/UX-агента;
• docs/ui-agent/;
• developer documentation strategy;
• agent workflow/roles/policy/context/status;
• ADR 0027.

Product code, runtime, Docs deploy, credentials, test server и production не входят в эту задачу.

Критерии

1. Новая внешняя задача появляется только в docs/ui-agent/TASK.md.
2. При status: EMPTY внешний агент не начинает новую работу.
3. При READY агент читает полный developer-сайт и working memory.
4. Result сохраняется в docs/ui-agent/results/<task-id>/revision-<task-revision>/ без перезаписи прошлых ревизий.
5. Memory сохраняется отдельно от текущего brief и Product implementation.
6. Сообщение владельца о завершении запускает внутренний intake result folder.
7. Reference не трактуется как готовый код или разрешение deploy.
8. Docs site честно обозначен как ещё не созданный.
9. Готовая ревизия не запускается повторно, а закрытая задача возвращается в EMPTY только внутренним координатором.
10. Только явно принятые пункты MEMORY_DELTA переносятся в memory/ACCEPTED.md.

Dry-run

Сценарий	Результат
TASK.md имеет EMPTY	Новая внешняя работа отсутствует
Docs site ещё не опубликован	Task остаётся EMPTY
Владелец заполнил READY и result_path	Агент изучает docs/brief/memory и создаёт reference package
Для тех же task_id и task_revision уже есть EXTERNAL_RESULT_READY	Повторный запуск блокируется; result ожидает решения владельца
Agent вернул только один happy-path screenshot при обязательных states	External result неполон; владелец возвращает задачу агенту
Result получен	Координатор ставит AWAITING_OWNER_REVIEW; внешняя работа останавливается
Владелец запросил доработку	Координатор увеличивает task_revision, задаёт новый result path и возвращает READY
Владелец сообщил, что внешняя задача завершена	Команда фиксирует result, переносит явно принятую memory, формирует implementation task и возвращает task в EMPTY
Memory item не принят явно	Он остаётся PROPOSED только внутри result
Reference содержит HTML/CSS	Используется как образец, не копируется автоматически в runtime
Внутренняя реализация готова	Test server/deploy выполняются только отдельным разрешённым этапом

Проверка

Требуются structural Markdown/path/link checks, scope/secret/size review и независимая проверка процесса перед handoff.

Независимая проверка

• Первичная проверка: REJECTED из-за отсутствия terminal task transition и определённого переноса принятого MEMORY_DELTA.
• Исправление: добавлены состояния AWAITING_OWNER_REVIEW/EMPTY, защита от повторного запуска той же ревизии, revision-specific result paths и controlled promotion в memory/ACCEPTED.md.
• Повторная проверка: VERIFIED; все 10 критериев прошли.
• Решение координатора: ACCEPTED_FOR_HANDOFF для documentation-only процесса.
• Не разрешены этим решением: commit, push, Docs deploy, test-server deploy, production или другие внешние действия.