Это обычный Markdown-файл с инструкциями для кодинг-агентов, обязательных полей в нём нет. Формат вырос из практики OpenAI Codex, Amp, Jules, Cursor и Factory. Сейчас его курирует Agentic AI Foundation в составе Linux Foundation. Среди инструментов, которые читают файл, сайт называет Gemini CLI, Aider, Zed, Warp, opencode, Windsurf и ещё около десятка.
Как агент выбирает инструкции:
- В монорепо у каждого пакета может быть свой AGENTS.md, и побеждает ближайший к редактируемому файлу. В основном репозитории OpenAI таких файлов 88.
- Прямой запрос в чате важнее любого файла.
- Команды тестов из файла агент попытается запустить и починить упавшее до конца задачи.
Что стоит туда записать:
1. Команды сборки и тестов дословно, как в CI.
2. Соглашения по коду, которых нет в конфиге линтера.
3. Опасные места вроде миграций и секретов, куда агенту нельзя без вопроса.
4. Ошибку, которую агент повторил дважды. Одна строка в файле обходится дешевле третьего повтора.
Промпт дня:
Изучи репозиторий и CI. Составь AGENTS.md: команды установки, сборки, тестов и линтера в точности как в CI, соглашения по коду, которых нет в конфигах линтера, и места, куда нельзя лезть без вопроса. Не выдумывай команд: для каждой укажи путь к файлу, где она найдена.
Источник: https://agents.md/
Какую команду агенты в вашем репозитории чаще всего запускают неправильно?