iskronify
Repo-boost
Приведи текущий репозиторий к агентскому стандарту iskron: плотный, AI-first AGENTS.md (читается каждую сессию, а не человеком однажды) + CLAUDE.md, указывающий на него, ритуалы сессии с графом, прошитые хуками, и гейт качества. Конфиг ты генерируешь из скелета — ничего не копируется руками, пользователь не вставляет шаблонов.
Настоящий деливерабл — интерфейс доверия: документ, которому агент может верить каждую сессию, а не просто красиво-плотный файл. AGENTS.md — производный вид, проекция источников, которые уже держат истину (код, package.json, конфиг CI, файловая система, граф), плюс тонкий слой авторского суждения (готчи, why-клаузы), который больше нигде не живёт. Поэтому контракт двуглав: плотность (каждая строка меняет поведение) и точность (каждая производная строка перепроверена против источника в этом прогоне). Плотная ложная строка хуже многословной — короткую и уверенную агент глотает без сопротивления. Проверяй с той же строгостью, с какой сжимаешь.
Скелет тела живёт в references/agents-template.md (относительно этого скилла). Прочти его: это набор ##-секций, которые обязан иметь готовый AGENTS.md, со слотами <…> и немногими заметками <!-- … -->. Заполни слоты, выброси неприменимые опциональные строки/секции, вычисти каждую заметку, не оставь ни одной угловой скобки. Скелет — что произвести; этот файл — как.
Контракт: 6. Шаг 7 штампует это число в каждый записанный AGENTS.md. Увеличивай на единицу только когда перемена здесь или в скелете делает уже сгенерированный файл неверным — секция добавлена, переименована или изъята, ритуал изменён, имя тула выпало; никогда — ради формулировок. Репо с меньшим штампом получает полную дугу, и ты называешь контракт, из которого пришёл его конфиг.
То же число стоит первым словом в description — и это не дубль, а несущая копия. Скилл-тело агент читает только после загрузки, а загружается скилл по описанию: номер, живущий лишь здесь, не может сработать триггером никогда — сравнить его не с чем, пока не позовут руками. В контексте всякой сессии сходятся ровно две вещи — список скиллов с их описаниями и AGENTS.md со штампом; сравнение возможно только между ними. Потому число дублируется нарочно, а расхождение двух копий ловит make validate.
Это простой счётчик, и он нарочно ни дата, ни версия плагина. Дата не выражает двух перемен в один день — второй нечем объявить себя. Версия релиза движется на каждом релизе, включая не трогающие ни одного скилла здесь, — штамповать её значило бы объявлять каждый конфиг устаревшим после любого релиза, а сигнал устаревания, срабатывающий постоянно, перестают читать. Этот счётчик — собственность шаблона и движется только когда его выход становится неверен. Конфиг со штампом-датой предшествует этой схеме — считай его ниже любого числа и прогони полную дугу.
Редакция установленной поставки сверяется здесь, и только здесь. Скилл не несёт на себе своей версии, а установленная копия отстаёт от сопровождаемой на выпуски; протухший текст читается так же авторитетно, как текущий, и его дефекты предстают дефектами метода. Поэтому всякий прогон — полный или рефреш — начинается сверкой того, что бежит, с тем, что выпущено, и тот же ход агент делает, прежде чем назвать инструкцию скилла неверной (туда его шлют feedback и entry):