Файл AGENTS.md помогает ИИ-агентам соблюдать правила проекта
Вайб-проекты, создаваемые с помощью ИИ, часто теряют архитектурную целостность при переходе к новой сессии. Чтобы агент не нарушал договоренности, достигнутые в прошлом чате, разработчики используют файл AGENTS.md.
Когда диалог с ИИ завершается, накопленные знания о структуре проекта пропадают. В новой сессии агент может начать писать SQL-запросы в сервисах или создавать лишние колонки, которые противоречат логике базы данных. Чтобы этого избежать, правила переносят в файлы инструкций, которые подгружаются автоматически.
Для эффективной работы файл не должен дублировать то, что агент и так видит в коде. Если решение очевидно из структуры репозитория, записывать его нет смысла. Автор предлагает сначала проверить, какие именно правила нарушает модель в сессиях без инструкций, и только их заносить в файл. Это помогает избежать раздувания документации.
Эффективное правило должно содержать название решения, причину и четкий признак нарушения. Например, запрет на использование флагов вроде cancelled_at в пользу одного поля status. Если у правила нет наблюдаемого признака, его будет сложно проверить при автоматизированном ревью кода.
Подход с использованием файлов контекста становится стандартом. С декабря 2025 года стандарт AGENTS.md существует в рамках Agentic AI Foundation при Linux Foundation, где его используют более 60 000 проектов. Другие инструменты используют свои форматы: Claude Code работает с CLAUDE.md, а Gemini CLI, с GEMINI.md.
Перед внедрением новых правил стоит проверить, как ваш инструмент работает с файлами контекста. В зависимости от настроек агент может подхватывать инструкции автоматически или требовать ручного указания пути к файлу.
Что поменялось
Вместо устных договоренностей в чате правила проекта фиксируются в файле AGENTS.md, чтобы ИИ-агенты соблюдали их во всех новых сессиях.
· обновлено, версия 6
Источники · 1
Текст подготовила языковая модель по материалам источников.
