раздел 00

Что такое артефактное мышление

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

Артефактное мышление - привычка фиксировать результат каждого законченного шага в файл, а не оставлять его в чате.

Артефакт - это файл с зафиксированным результатом шага: резюме звонка, план работ, принятое решение, чек-лист, реестр. Чат - процесс. Файл - результат.

Что считается артефактом

Результат бывает разный, и файл под него тоже. Резюме встречи на десять строк. План работ с галочками. Файл решения: что решили, почему, что отвергли. Журнал изменений, где новые записи сверху. Чек-лист проверки перед сдачей. Реестр - список клиентов, ссылок, контактов с пометками.

Общее у них одно: это законченный кусок смысла, который лежит в проекте отдельным файлом, а не размазан по сорока сообщениям.

Противоположность: всё живёт в чате

Чат кажется удобным местом для работы, потому что там всё под рукой. Пока чат открыт. Проблемы начинаются потом.

Забывается
Решение принято на двадцатом сообщении, а на сотом агент уже действует наперекор ему, потому что «не заметил».
Переполняется
Контекстное окно конечное. Когда оно забито, агент теряет начало разговора вместе с постановкой задачи.
Стартует с нуля
Новый чат ничего не знает о старом. Вся история остаётся у вас в голове и в прокрутке.
Не передаётся
Коллега, субагент или вы сами через месяц - никто не будет читать сто экранов переписки, чтобы понять, на чём остановились.

Каждая из этих проблем по отдельности терпима. Вместе они означают, что работа с агентом не накапливается: каждая сессия - с чистого листа, каждая передача - через пересказ.

Чем файл лучше

Файл читается любым агентом и любым человеком. Ему не нужен именно тот чат и именно та модель. Открыли SUMMARY.md - и через минуту в курсе.

Файл лежит в проекте, рядом с кодом, документами, другими файлами. Он находится поиском, открывается в IDE, его видно в списке папки. Чат - отдельный мир, в который нужно специально заходить.

Файл версионируется. Если папка под git, у каждого артефакта есть история: кто, когда и что поменял. Можно вернуться к вчерашней версии плана. У чата истории нет, только прокрутка.

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

Как это отличается от курса про самоулучшение

На этом сайте есть соседний курс Артефакты и самоулучшение. Слово то же, смысл другой. Там артефакт - зафиксированный урок или правило: агент ошибся, вы записали правило в AGENTS.md / CLAUDE.md, в следующий раз он не ошибается. Тот курс о том, как агент становится лучше со временем. Здесь артефакт - промежуточный результат конкретной работы: резюме, план, решение, зафиксированные файлом, чтобы следующий шаг, следующий чат или другой человек могли продолжить. Этот курс о том, как работа не теряется. Оба подхода живут вместе: правила говорят агенту, что писать артефакты, а артефакты дают материал для новых правил.

Что разберём дальше

  • 01 - три выигрыша: контекст, передача, проверяемость. И пример, как одна и та же задача идёт без файлов и с ними.
  • 02 - виды артефактов с шаблонами: резюме, план, решение, журнал, чек-лист, реестр, «что дальше».
  • 03 - цикл работы и готовые промпты.
  • 04 - как вписать это в правила агента, чтобы он писал файлы сам.
  • 05 - сквозной пример: коммерческое предложение через цепочку файлов.
  • 06 - шпаргалка.