Сигнал из хука Клауд дев: файл AGENTS.md назван самым частым источником бесполезного расхода токенов, и к этому приложен готовый промпт на уборку через навык /writing-for-agents из набора Matt Pocock. Мысль простая, но её почти никто не применяет: файл инструкций агента — это не документация, а налог, который вы платите в начале каждой сессии. Ниже — почему так, что именно резать и как сделать уборку безопасной. Витрина — vibe-studio.uk; трафик-контур — TG Lead Finder.
Соседи: AGENTS.md и skills под GPT-6, Cache Control в Claude Code, как экономить лимиты Claude Code, каталог skills для Claude Code и Codex.
Почему AGENTS.md стоит денег каждый день
Codex читает AGENTS.md, Claude Code читает CLAUDE.md. В обоих случаях файл подгружается в контекст в начале работы, а не по запросу. Значит, каждая строка в нём оплачивается в каждой сессии, в каждом субагенте и после каждого сброса контекста. Если файл вырос до нескольких сотен строк, вы платите за них даже тогда, когда агент правит одну опечатку в README.
Второй эффект менее заметен: длинный файл хуже работает. Когда правил много, агент начинает выбирать, каким следовать. Важное правило про миграции базы тонет между советом «пиши понятные коммиты» и устаревшей инструкцией про библиотеку, которую давно выкинули.
Откуда берётся бардак
- Правила на всякий случай. «Пиши чистый код», «думай перед ответом» — модель и так это делает, строки ничего не меняют.
- Следы старых ошибок. Агент один раз сломал сборку, в файл дописали запрет. Причину давно убрали, запрет остался.
- Справочник вместо инструкции. Полное описание архитектуры, все команды, все переменные окружения. Нужно раз в неделю, грузится каждый раз.
- Стиль кода внутри. Отступы, нейминг, порядок импортов. Это нужно при правке кода, а не при каждом вопросе к агенту.
Три направления уборки
Промпт из хука просит три вещи, и каждая решает свою часть проблемы.
- Убрать инструкции, которые ни на что не влияют. Проверка на каждую строку: если её удалить, изменится ли поведение агента? Если нет — строка лишняя.
- Раскрывать подробности по мере необходимости. В корневом файле остаётся короткая карта: что за проект, где что лежит, какие команды запускать. Детали уходят в отдельные файлы, на которые есть ссылка, и агент открывает их, только когда задача туда ведёт.
- Вынести стандарты в CODING_STANDARDS.md. Правила стиля нужны при написании кода, поэтому живут отдельно и подтягиваются, когда агент действительно пишет код.
Зачем три субагента с разной жёсткостью
Самая интересная часть промпта — работа идёт через трёх субагентов, и каждый действует радикальнее предыдущего. Первый чистит аккуратно, второй смелее, третий режет по максимуму. Итог собирается в один PR.
Это снимает главный страх уборки: удалить что-то важное. Вы видите три варианта рядом и выбираете уровень, а не спорите с одним агентом, который либо почти ничего не тронул, либо вырезал половину. Один PR удобен тем, что изменения легко посмотреть в диффе и откатить.
Как сделать это у себя
- Поставить навык /writing-for-agents из репозитория mattpocock/skills. Без него промпт не сработает так, как задуман: навык и задаёт правила хорошего файла инструкций.
- Своими словами попросить агента: мой AGENTS.md в беспорядке, предложи изменения структуры, которые уберут бесполезные инструкции, вынесут детали в файлы по требованию и перенесут стиль кода в CODING_STANDARDS.md; сделай это тремя субагентами, каждый смелее предыдущего, и собери один PR.
- Посмотреть дифф и выбрать уровень. Обычно разумный вариант — второй.
- Неделю поработать с новым файлом и замечать, где агент начал ошибаться. Вернуть только те правила, без которых реально стало хуже.
Что не вырезать
- Команды сборки, тестов и линтера — без них агент гадает и тратит больше токенов на разведку.
- Запреты, за которыми стоят деньги и данные: не трогать прод-базу, не коммитить ключи, не пушить в main.
- Нестандартные решения проекта, которые агент не угадает сам: свой роутинг, своя схема слагов, нестандартный деплой.
Связь с трафиком
Вайб-кодер обычно держит несколько проектов сразу: лендинг, бот, парсер, админку. Лишние токены в каждом AGENTS.md складываются в заметную долю лимита, особенно когда работают параллельные сессии. Сэкономленный лимит — это лишний лендинг под связку или ещё один прогон правок сайта, который приводит людей из Telegram-трафика.
Коротко
AGENTS.md и CLAUDE.md грузятся в каждую сессию, поэтому каждая лишняя строка стоит токенов каждый день. Уберите правила, которые ничего не меняют, оставьте в корне короткую карту, детали раскрывайте по требованию, стиль кода вынесите в CODING_STANDARDS.md. Навык /writing-for-agents и три субагента разной жёсткости дают выбор уровня уборки в одном PR. Ещё про экономию — лимиты Claude Code и управление контекстом в Codex.