раздел 01

Виды артефактов

Артефакт может выглядеть по-разному. Строчка правила, целый навык, запись в памяти, короткая заметка после задачи. Все они делают одно: переносят урок из головы в место, куда агент заглянет в следующий раз. Разница в том, что именно вы фиксируете и как часто это нужно.

Правила
Постоянные договорённости: как оформлять код, что нельзя делать, каким стилем писать. Живут в AGENTS.md или rules.
Навыки
Готовые процедуры под повторяющуюся задачу - собранный в отдельный skill сценарий, который агент подхватывает по триггеру.
Память
Долгие факты о проекте и о вас: стек, реквизиты, решения. Живут в memory.md и переживают сессии.
Заметки и ретро
Короткий разбор после задачи: что сработало, что нет. Сырьё, из которого рождаются правила и навыки.
Шаблоны
Готовые заготовки: структура письма, каркас документа, типовой промпт. Не пишешь заново каждый раз.
Чек-листы
Список проверок перед сдачей: что не забыть. Ловит те ошибки, которые уже случались.

Разные артефакты - один смысл: перенести урок из разовой сессии в постоянное место, куда агент заглянет в следующий раз.

Правила: AGENTS.md и rules

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

Подробнее про формат - в разделе AGENTS.md и CLAUDE.md.

Навыки: skills

Когда задача повторяется и у неё есть понятный сценарий, его собирают в навык. Навык - это не одна строчка, а целая процедура: что сделать, в каком порядке, чего избегать. Агент подхватывает навык по триггеру и выполняет по шагам.

Подробнее - в разделе Skills.

Память: memory.md

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

Подробнее - в разделе Память агента.

Заметки и ретро

Заметка после задачи - самый дешёвый артефакт и одновременно источник всех остальных. Записали в двух строчках, что пошло не так, а потом превратили это в правило или навык. Про сам механизм - в следующем разделе.