Приёмка работы ИИ-агента: отчёт о соответствии вместо просмотра экранов

Узкое место сместилось

Раньше узким местом было производство: сверстать каталог, карточку товара, корзину, админку. Агент закрывает это за ночь. Теперь узкое место — я. Открываю экран, смотрю, думаю «вроде похоже», иду дальше. Через двадцать экранов внимание садится, и в приёмку проскакивает всё подряд.

Ручной просмотр проверяет впечатление. Дизайн-система задаёт числа: Unbounded 22/600, #18161A, border-radius: 999px, контентная ширина 1440 px. Глазом такое не ловится.

Отчёт о соответствии

На проекте SexyGram — магазин по дизайн-системе из 14 разделов холста — я поменял порядок. Агент заканчивает фазу и пишет документ. Внутри — разбивка по зонам ответственности:

Фаза 4 · Агент A — каркас витрины и главная. Зона: app/(shop)/layout.tsx, app/(shop)/page.tsx, components/layout/**, components/age-gate/**, components/home/**.

Дальше идёт список расхождений с эталоном. Каждая запись обязана нести одну из четырёх меток:

• дефект вёрстки — эталон есть, реализация мимо. Чинить молча.
• осознанное отклонение — агент отступил специально и объясняет почему. Решаю я.
• пробел в спеке — эталон молчит, поведение пришлось выбрать. Дописываю спеку.
• достроено (эталона в холсте нет) — целого блока в дизайне нет, агент собрал его сам.

Почему меток именно четыре

Бинарная приёмка «сделано / не сделано» склеивает случаи с разной ценой ошибки. Дефект вёрстки стоит десять минут. Блок, которого в дизайне никогда не было, стоит месяцы: он расползается по проекту так, будто он часть системы, и его потом никто не решается тронуть.

Живой пример — футер. В холсте SexyGram футера нет ни в одном разделе. Агент собрал его из типографики соседних блоков и пометил «достроено, эталона в холсте нет». Без этой метки я бы принял его как часть дизайн-системы и полгода тиражировал отсебятину.

Обратный случай — пробелы. В спеке 06 записано прямо: a:hover { color: #B32E6E; } — единственный hover, заданный в прототипе, остальные hover-состояния в нём отсутствуют. Значит агент их придумает. Пусть придумывает, я хочу видеть каждый такой выбор отдельной строкой отчёта.

Отчёт работает только поверх эталона

Сам по себе отчёт — бумажка. Он живёт за счёт того, что спеки сняты с холста дословно и до начала работы, с координатами источника: «Источник: design/SexyGram-design-system.dc.html, строки 886–1108, блок id="3b"». Где параметра в прототипе нет, стоит явная пометка «не задано в прототипе».

Эта пометка и делает отчёт проверяемым. У агента появляется словарь для разговора о дырах в задании. Без словаря он молча закрывает дыру своим решением, и я узнаю об этом на третьей фазе, когда админка уже живёт по своим правилам.

Как выглядит приёмка по факту

1. Читаю метки. Дефекты вёрстки уходят в работу без обсуждения.
2. Осознанные отклонения читаю целиком — их обычно три-пять на фазу.
3. «Достроено» открываю глазами. Только здесь я реально смотрю экран.
4. Пробелы в спеке переношу в docs/specs в тот же день, иначе следующая фаза придумает своё.
5. Выборочно проверяю две-три записи по указанным строкам источника — держу агента честным.

Время приёмки фазы упало с «весь вечер» до получаса, и это получас осмысленной работы вместо листания.

Где отчёт врёт

Агент отчитывается сам о себе. Пропущенное расхождение в отчёт не попадёт: он не видит того, чего не заметил. Поэтому гейт уровня 2 из плана — визуальная сверка структуры — остаётся. Проходить экраны с отчётом в руках получается совсем иначе: я знаю, куда смотреть.

Второй риск — метка «осознанное отклонение» превращается в отмазку. Лечится требованием формата: в записи должна быть строка эталона и причина отступления. Формулировка «так лучше» отклоняется вместе с записью.

Что забрать себе

• Эталон снимается дословно до старта работ, с координатами источника и честными пометками о пропусках.
• Приёмка — это документ от агента, где каждая запись классифицирована.
• Глазами проверяется прежде всего то, что агент достроил по своему усмотрению.
• Пробелы возвращаются в спеку сразу, пока контекст свежий.

Схема переносится на любую работу с жёстким эталоном: вёрстка по макету, миграция схемы БД, перевод документации. Везде, где есть источник истины, приёмку можно превратить из просмотра в чтение.