Как я залил npm-пакет с AGENTS.md — и почему это спасёт ваш код от ИИ-хаоса

Представьте: вы захотели использовать новую библиотеку, но ваш AI-помощник (Copilot, ChatGPT, кто угодно) начинает выдавать дичь, потому что он просто угадывает API. Знакомая боль? Разработчик Jeet Vora решил эту проблему раз и навсегда: он добавил в свой npm-пакет файл AGENTS.md.

Что за зверь такой AGENTS.md?

Это как README, но не для людей, а для AI. В этом файле вы описываете, как именно AI должен взаимодействовать с вашим кодом: какие функции использовать, какие паттерны избегать, какие версии поддерживать. Jeet Vora сделал это для своего пакета shimmer-trace — скелетон-лоадера для React, который анализирует реальный DOM и рисует красивые заглушки во время загрузки.

Теперь, когда разработчик подключает shimmer-trace и спрашивает AI: "Как добавить скелетон для карточки товара?", AI читает AGENTS.md и выдаёт корректный код, а не "попробуйте useEffect с setTimeout". Это как дать инструкцию стажёру, только стажёр — нейросеть.

Почему это гениально (и немного грустно)

Грустно потому, что мы дошли до жизни такой: нам нужно документировать код для AI отдельно. Но гениально — потому что это реально работает. Если каждый пакет будет иметь AGENTS.md, AI-ассистенты перестанут галлюцинировать API, которых не существует. Представьте, сколько багов можно избежать, если AI будет знать, что ваш метод называется fetchData, а не getData.

Кроме того, это отличный способ намекнуть AI на best practices. Хотите, чтобы он всегда использовал async/await вместо промисов? Пропишите в AGENTS.md. Хотите, чтобы избегал lodash? Напишите это там. AI послушно выполнит.

Комментарий студии METABYTE: Мы, конечно, не против AI-ассистентов, но если они начнут читать AGENTS.md, то, может, и JIRA на 47 столбцов станет понятнее? Шутка. А если серьёзно, такой файл — отличный способ сэкономить часы на код-ревью, когда AI генерирует код, а вы только проверяете. Мы бы добавили AGENTS.md в каждый наш проект, если бы не боялись, что AI начнёт требовать повышения зарплаты.