Читать пост Marcos Hernanz в X
В ролике @ii.systema говорят, что разработчик сжёг 60 миллиардов токенов, а потом опубликовал файл правил, с которым пишет код вместе с ИИ. По словам автора ролика, файл заставляет модель искать простые решения, читать документацию и экономить лимиты.
Этого разработчика зовут Marcos Hernanz. Он работал над Next.js в Vercel. 2 августа 2026 года он написал в X: «After doing ~60B tokens, this is my full AGENTS.md». В посте было семь правил. Через несколько часов он добавил в ответе восьмое, со словами «Almost forgot».
Что такое AGENTS.md
AGENTS.md — это обычный текстовый файл в главной папке проекта. ИИ-агенты читают его перед началом работы, поэтому правила пишутся один раз, а не в каждом чате. Claude Code читает его, если в проекте нет файла CLAUDE.md.
Восемь правил простыми словами
- Не держите старый код живым. Когда что-то заменили, удалите старый путь. Не добавляйте запасные варианты и слои, чтобы он продолжал работать.
- Выбирайте самое простое решение, которое полностью делает работу сегодня. Не добавляйте настройки и слои «на всякий случай».
- Растите маленькими шагами. Сначала сделайте самую маленькую версию, которая работает от начала до конца. Потом добавляйте по одной функции поверх того, что уже работает.
- Держите части отдельно. Каждая часть делает одно дело.
- Берите хорошую известную библиотеку, если она делает всё проще или надёжнее. Не переписывайте обычные функции без причины.
- Проверьте, что уже есть в проекте, прежде чем добавлять пакет или писать свой код. Прочитайте документацию и типы библиотеки, прежде чем решить, что она чего-то не умеет.
- Решайте на долгий срок. Никаких быстрых заплаток, которые потом придётся выбросить.
- Прежде чем что-то проектировать, посмотрите, как ту же задачу решают хорошие зрелые продукты. Берите их проверенные подходы, а не придумывайте свои.
Почему это может экономить токены
Большинство этих правил говорят агенту писать меньше: без лишних слоёв, без копий библиотек, без кода ради старых версий. Меньше кода — меньше читать, исправлять и объяснять на следующем шаге. Шестое правило — это то, что в ролике называют «читать документацию». Marcos не называет цифр, сколько токенов экономит файл.
Предупреждение от автора
Под своим постом Marcos добавил: он использует этот файл только для своих небольших проектов, и не стоит применять его в продакшене, если не хотите разрушить свой код. Самое рискованное — первое правило. В настоящем продукте удаление старых путей может сломать всё тем, кому они ещё нужны.
Как этим пользоваться
Создайте файл AGENTS.md в главной папке проекта. Скопируйте восемь правил из двух его постов и поменяйте те, что не подходят вашему проекту. Если вы пользуетесь Claude Code и у вас уже есть CLAUDE.md, добавьте в него одну строку, чтобы Claude читал оба файла:
@AGENTS.md