Исчерпывающее руководство по AGENTS.md

Файл AGENTS.md — самый важный файл в вашей системе управления кодом ИИ, и если вы заполните его неправильной информацией, ваши агенты станут медленнее и примерно на 20% дороже. В этом видео я подробно разбираю, что на самом деле должно быть в файле AGENTS.md (и CLAUDE.md), что следует исключить и как проверить уже имеющиеся файлы. Исследование ETH Zurich (февраль 2026 г.) протестировало агентов программирования, таких как Claude Code и Codex, на сотнях реальных задач GitHub и обнаружило, что контекстные файлы, содержащие информацию, которую агент может вывести из кода — например, структуру вашего репозитория — снижают успешность выполнения задач, одновременно увеличивая стоимость вывода до 20%. Агенты программирования сильно оптимизированы для чтения кода. Ваш контекстный файл должен содержать только то, что код не может им сообщить. Я работаю программистом более 15 лет (в настоящее время в Meta) и ежедневно работаю с этими файлами в Claude Code и Codex. Я покажу вам одно правило, которое я применяю к каждой строке — «можно ли это вывести из кода?» — а также как работают три уровня файлов (корневой, проектный и подкаталог), как сделать ваш репозиторий независимым от агента с помощью импорта в одну строку, когда навык важнее контекста, и точный запрос, который я использую для аудита своих файлов. Затем я проведу этот аудит вживую на своей реальной системе — со всем устаревшим мусором — чтобы вы могли увидеть процесс, а не только отполированный результат. ЧТО ВЫ УЗНАЕТЕ • Единственное правило, определяющее содержимое контекстного файла (выводимые или невыводимые данные) • Что показали исследования об успешности выполнения задач и стоимости токенов • Что заслуживает своего места: команды, рабочие соглашения, такие как TDD, инварианты продукта • Корневые, проектные и подкаталоги файлов — и что должно находиться на каждом уровне • Сохранение независимости от агента в Claude Code, Codex, Cursor и Copilot (импорты или символические ссылки) • Когда следует перемещать инструкции в навык, чтобы они загружались только при необходимости • Подсказка для копирования и вставки, чтобы проверить и отредактировать собственный файл РАЗДЕЛЫ 00:00 Почему AGENTS.md важен для агентов ИИ 01:45 Что НЕ следует помещать в AGENTS.md 03:03 Исследование: Контекстные файлы могут навредить (+20% стоимости) 05:45 Что должно быть: команды, соглашения и Инварианты 09:21 CLAUDE.md против AGENTS.md: Настройка, не зависящая от агента 10:41 Три уровня файлов: Корневой, Проектный, Подкаталог 12:38 Файлы корневого уровня: Символические ссылки против импорта 14:41 Что размещается на корневом уровне и на уровне проекта 19:32 Навыки против контекстных файлов: Загрузка по запросу 22:49 Лучшие практики: Добавляйте по одному элементу за раз 24:23 Аудит в реальном времени: Обрезка моих реальных файлов 29:25 Заключение: Altitude и семинар РЕСУРСЫ 📄 Научная статья (ETH Zurich): https://arxiv.org/abs/2602.11988 📋 Фрагменты из этого видео (повторный вход в контекст, TDD, принятие технических решений): https://github.com/jasonku09/agents-m... 🛠️ Шлюз без ошибок от Куна Чена: https://github.com/kunchenguid/no-mis... 🎬 4 уровня программирования с ИИ:    • The 4 Levels of Coding With AI (Most Peopl...   🚀 Altitude — научитесь программировать с ИИ, созданный для полных новичков. Присоединяйтесь к списку ожидания: https://learnaltitude.com 🔧 Мастерская — мое бесплатное сообщество для людей, которые учатся создавать приложения с ИИ. Я отвечаю на все вопросы: https://jasonk.us/workshop #ClaudeCode #AICoding #CodingAgents #ContextEngineering