Зачем: контекст, передача, проверка

Три причины переводить работу с агентом на файлы. Каждая по отдельности уже окупает привычку. Вместе они меняют то, как вообще выглядит день с агентом.

Контекст: страница вместо тома

У агента есть контекстное окно - объём текста, который он держит в голове одновременно. Оно большое, но конечное, и главное - чем оно полнее, тем хуже агент работает: путает детали, забывает ограничения, повторяет уже сделанное. Подробно это разобрано в курсах Контекстное окно и Управление контекстом.

Переписка растёт быстро. Два часа работы - это десятки тысяч слов: ваши вопросы, ответы агента, выводы команд, куски файлов, тупиковые ветки. Из всего этого важного - страница: что решили, что сделали, что осталось.

Артефакт и есть эта страница. Когда агент читает SUMMARY.md вместо истории чата, он получает ту же суть за одну сотую объёма. Окно остаётся свободным для работы, а не для воспоминаний.

Переписка - это история того, как вы пришли к результату. Агенту для следующего шага нужен результат, а не история.

Передача: между чатами, агентами, людьми

Между чатами. Любой чат рано или поздно надо закрывать: переполнился, сменилась тема, просто конец дня. Как устроена жизнь чатов и почему их стоит заводить под задачу - в курсе Чаты. Файл-резюме делает закрытие безболезненным: новый чат стартует с «прочитай SUMMARY.md и продолжай».

Между агентами. Когда вы отдаёте часть работы субагенту, у него свой контекст, и вашей переписки он не видит. Единственное, что можно ему передать, - текст задачи. Если вместо длинного пересказа он получает «прочитай brief.md и research.md», задача ставится точнее, а результат он тоже кладёт в файл, который вы читаете глазами.

Между людьми. Коллега не станет читать ваш чат. Он не поймёт, где важное, а где шум, и вообще не факт, что чат ему доступен. Папка с файлами PLAN.md, decisions.md, NOTES.md понятна за пять минут. И вам самим через месяц - тоже.

Проверка: открыть, поправить, вернуть

В чате результат сливается с процессом. Финальный план размазан по трём сообщениям, в каждом что-то уточнено. Чтобы проверить, нужно прочитать всё и собрать в голове.

Файл - это одно место, где лежит текущая версия. Открыли, прочитали, увидели ошибку: агент решил, что клиент хочет обучение на 20 человек, а их 200. Поправили строку. Сохранили. Сказали агенту: «перечитай brief.md, там правка». Дальше он работает с верным числом, и все следующие шаги тоже.

Это дешёвая проверка. Она не требует перечитывать переписку и не требует объяснять агенту, что именно он понял неправильно. Просто исправленный файл.

Пример: исследование конкурентов

Задача одна: собрать обзор по десяти конкурентам - продукт, цена, позиционирование, слабые места.

Без артефактов. Открыли чат, попросили агента поискать. Он находит первых трёх, вы уточняете критерии, он ищет дальше. Через час в чате уже двадцать экранов: результаты поиска, таблицы, ваши комментарии, его исправления. На третьем часу агент начинает путать компании: приписывает цену одной другой, забывает, что четвёртую вы уже отбросили. Вы просите «собери всё в итоговую таблицу», он собирает по памяти, и в таблице снова ошибки, потому что часть переписки уже выпала из окна. Закрыли чат - и обзор существует только в виде последнего сообщения, которое надо скопировать куда-то руками.

С артефактами. Первым сообщением: «Заведи research.md с таблицей: компания, продукт, цена, позиционирование, слабые места, источник. Обновляй после каждого найденного конкурента, я буду проверять». Агент ищет, вписывает строку, вы смотрите файл. Увидели, что четвёртая компания не подходит, - удалили строку руками, написали «четвёртую убрал, она из другого сегмента». Через час файл содержит десять проверенных строк. Чат можно закрывать. Завтра другой чат или другой человек открывает research.md и пишет выводы. Ничего не потерялось, ничего не перепутано, каждая цифра со ссылкой на источник.

Модель та же, промпты почти те же. Поменялось одно: где живёт результат.

Что дальше

В следующей главе - какие бывают артефакты и как выглядит шаблон каждого. Их немного, и у каждого есть свой момент, когда его пора заводить.