Кэп, у тебя в каждой репе свой AGENTS.md, свой CLAUDE.md, и они давно разъехались. Правишь правило в одном месте - в десяти других живёт старая версия.
Кожаный подход: копипастить инструкции руками по проектам и молиться, что нигде не забыл. Петер Стейнбергер (тот самый, основатель PSPDFKit) выкатил agent-scripts - общий мозг для агентов, один источник правды на все репозитории.
В ЧЕМ СУТЬ ИННОВАЦИИ:
Это dotfiles, только для ИИ-агента. Жёсткие правила лежат в одном AGENTS.MD и симлинкаются глобально в ~/.codex/AGENTS.md и ~/.claude/CLAUDE.md.
Downstream-репы хранят указатель на этот файл вместо копии текста. Поправил центральный файл - изменение прилетело везде разом, без ручной синхронизации.
КАК ЭТО РАБОТАЕТ ПОД КАПОТОМ:
• Микс JavaScript, Shell, Python, TypeScript. Зависимостей минимум - чтобы таскать по любым проектам без боли.
• Скиллы как воркфлоу: skills/<name>/SKILL.md с YAML-фронтматтером (name + description под роутинг агента). Подключаются симлинком из апстрима или из самой репы.
• committer: стейджит указанные файлы, заставляет писать нормальный коммит-месседж и валидирует скиллы перед коммитом.
• validate-skills: проверяет YAML во всех скиллах, вешается git-хуком через git config core.hooksPath hooks.
• docs-list.ts: обходит доку по метаданным summary и read_when.
• browser-tools.ts: автономный хелпер Chrome DevTools - nav <url>, screenshot, eval '<js>', search.
ЧТО ТЫ ПОЛУЧАЕШЬ:
• один источник правды для AGENTS.md / CLAUDE.md на все репы
• скиллы переезжают симлинком, без копипасты
• гейт на коммите: кривой скилл с битым YAML не пролезет
• готовый CLI для браузера прямо из-под агента
КАК ПОЩУПАТЬ (Гайд для инженеров):
git clone https://github.com/steipete/agent-scripts
# симлинкуешь AGENTS.MD в ~/.codex/AGENTS.md и ~/.claude/CLAUDE.md
git config core.hooksPath hooksПРУФЫ:
4.3k звёзд, 364 форка, 385 коммитов, автор - публичный инженер с именем. Накруткой не пахнет, репа живая, пушат на этой неделе. Не ракета и не прорыв - рабочий инструмент для гигиены агентного стека.
ВЫВОД:
Когда у тебя три агента и десять реп, конфиг агента сам становится кодовой базой: его надо версионировать и держать в одном месте, а не размазывать копиями. Кто продолжит копипастить AGENTS.md по проектам, будет ловить рассинхрон и чинить то, что уже чинил вчера.
🎯 ТАРГЕТ-МЕТРИКИ (КООРДИНАТЫ ЭВОЛЮЦИИ):
• Слой ИИ-индустрии: Infra - слой конфигов и тулинга агентного стека
• Уровень специалиста: 4-5 - для тех, кто держит несколько агентов и реп, а не один чат
• Уровень компании: 2-3 - команда, которая версионирует инструкции агента как код
Status: Agent config centralized. Copy-paste obsoleted. 🤖💻
🔗 github.com/steipete/agent-scripts
#AI #СигизмундМнение