А эта статья тоже прям ломает шаблоны. Исследование от Vercel про то, как учить AI-агентов работать с фреймворками. Они тестировали два подхода для Next.js 16: Skills – открытый стандарт, где агент сам решает, когда загрузить документацию AGENTS.md – просто markdown-файл с индексом доков в корне проекта Результаты смотрите на картинке, AI плевать на ваши скиллы :) Агент их не вызывал практически никогда, пока прям напрямую не будешь писать, что их прям очень надо использовать, и даже тогда только в 79% случаев ИИ вызывала. А вот тупой markdown agents.md, в котором запихнули практически без красивостей все ссылки на документацию в итоге помогли в 100% случаев. Потому что агенту не надо принимать решение "а надо ли мне смотреть доки?", информация уже в контексте. Ключевая строчка, которую они добавили: IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning То есть смотри короче в файл и из него информацию бери, а не из своих закромов Практические рекомендации от Vercel: Не ждите, пока skills станут лучше – результат нужен сейчас, лучше использовать надежный agents.md Сжимайте агрессивно – полные доки в контексте не нужны, достаточно индекса на файлы Тестируйте на API, которые вышли недавно – именно там доступ к докам критичен Структурируйте доки так, чтобы агент мог читать конкретные файлы, а не грузить всё сразу Для Next.js проектов можно попробовать одной командой улучшить ваш agents.md: npx @next/codemod@canary agents-md Она скачает доки под вашу версию Next.js и добавит индекс в AGENTS.md. https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals