Про то, что AGENTS.md не нужен
Тут интернет увидел пейпер и внезапно засомневался в необходимости писать AGENTS.md. Вот раз, вот два, наверняка кого-то пропустил. У меня уже пару недель в заметках лежала мысль по этому же вопросу, поэтому давайте обсудим.
Если в двух словах, там написано, что с AGENTS.md и без него агенты выдают примерно одинаковые результаты. Если его сгенерил сам агент, то результаты хуже, чем без него. Если его писал человек, то могут быть чуть лучше. Но и в том, и в другом случае вам добавляются затраты на поддержку, а агенту - затраты (время и токены) на более подробное исследование перед работой, потому что вы его нагрузили лишней инфой.
Моя записанная мысль примерно так и звучала: никогда не используйте команду /init у агента, она генерит слоп, который и так очевиден. Если агент за минуту работы смог написать этот документ, то ему и без него было бы нормально, сам бы разобрался уже во время работы над задачей.
Но из этих обсуждений можно сделать вывод, что вообще никакую документацию агентам писать не нужно, в том числе и скиллы. А это немного разные вещи, если мы не говорим о бесполезных скиллах с инфой, которую модель и так знает.
Когда мы пишем доки - мы осознанно лишаем себя гибкости в пользу повторяемости результатов и того, чтобы агент без лишних грепов понимал, с чего начать анализ для задачи. Разобрался бы он сам? В большинстве случаев ответ - да. Но как быстро бы он к этому пришел? Непонятно. Мог бы он найти себе в качестве образца не то, что считаете образцом вы? Конечно.
Давайте считать, что AGENTS.md и скиллы - "временная" заплатка на то, что модели пока не научились (быстро) понимать в наших легаси проектах. Или способ описать неявное.
Да, лучше бы переписать код, чтобы он был однозначным и никогда не вел модели по ложному пути. Но прямо сейчас-то как-то жить тоже надо. Поэтому они нужны, а мы должны учиться их поддерживать, чтобы они не были хрупкими и описывали скорее идеи, цели и принципы, а не текущее положение дел. С текущим машина разберется, дайте ей только побольше способов проверить и поправить себя.
P.S. Давайте договоримся: вы просто мысленно в каждый пост будете добавлять фразу "с людьми так же", и я больше не буду это повторять в следующих.