Просите агента писать в файл, а не в чат
Ответ в переписке нельзя ни продиффить, ни прокомментировать построчно. Файл превращает разговор в работу с версиями.
Привычка, которая изменила мою работу с кодовыми агентами сильнее, чем любая правка промптов: результат должен попадать в файл, а не в ленту сообщений.
Разница не в удобстве чтения. В чате нет диффа. Агент присылает вторую версию — и чтобы понять, что изменилось, вы перечитываете обе целиком. На третьей итерации перестаёте перечитывать и начинаете верить на слово, а это ровно та точка, где качество проверки падает до нуля.
Файл даёт три вещи бесплатно. Дифф — видно только изменения. Историю — можно вернуться на версию назад. И построчный комментарий — можно показать конкретное место, а не пересказывать словами, какой абзац не нравится.
Побочный эффект оказался важнее основного: когда черновик лежит в файле,
он перестаёт быть одноразовым. План, написанный в чате, живёт до конца
сессии. Тот же план в docs/ через неделю оказывается документацией.
Работает и для текста, не только для кода. Статью, регламент, разбор инцидента — всё, что переживёт разговор, стоит сразу писать в файл.
Ограничение: у файла есть цена — его надо назвать и положить куда-то, и на короткой одноразовой задаче это лишний шаг. Граница проходит там же, где и всегда: если результат будет прочитан второй раз, он заслуживает файла; если нет — не заслуживает.