Дизайн-док на одну страницу: без него агент пишет не то

Агент получает задачу «добавь фильтр по районам» и придумывает требования сам. Через час у вас работает фильтр, который не нужен: не тот список, не то место на странице, выбор не сохраняется.

Поэтому у меня правило: пока нет дизайн-дока на одну страницу — агент в код не идёт. В нём пять блоков: что видит пользователь и где именно; что считается ошибкой; какие данные и откуда; чего делать нельзя; как проверить результат.

Пишу 15 минут — сам или моделью. Это не бюрократия: док потом превращается в приёмку. Сделано не по документу — правлю доку, а не спорю с агентом, что он «не понял».

Исключение — правка на один вызов: поменять текст ошибки, поправить отступ. Тут документ тормозит сильнее, чем помогает.