Генератор AGENTS.md
Заполните форму, чтобы получить AGENTS.md с вашими командами, соглашениями и жёсткими ограничениями. Вы также получите одно правило с ограничением по путям для Cursor, GitHub Copilot, Claude Code, Cline и Devin Desktop, а также файлы-связки для инструментов, которые не подхватывают AGENTS.md по умолчанию.
Где каждый инструмент ищет файлы инструкций →
# Веб-приложение Acme
Веб-приложение для клиентов с административной панелью и небольшим REST API.
## Учитывай стек
Next.js, React, TypeScript, pnpm
## Используй команды
- Установи зависимости: `pnpm install`
- Запусти локально: `pnpm dev`
- Запусти тесты: `pnpm test`
- Проверь lint и типы: `pnpm lint && pnpm tsc --noEmit`
- Собери проект: `pnpm build`
## Соблюдай стиль кода
- Соблюдайте правила форматирования, заданные линтером, и не изменяйте файлы, которые не затрагиваете.
- Отдавайте предпочтение небольшим функциям с понятными входными и выходными данными; побочные эффекты держите на границах системы.
- Прежде чем добавлять новую зависимость, спросите разрешения.
- Комментируйте причины неочевидных решений, а не объясняйте назначение каждой строки.
## Тестирование
- Для каждого изменённого поведения добавляйте или обновляйте тест.
- Запустите команду тестирования и исправьте ошибки, прежде чем сообщать о завершении.
- Не удаляйте и не пропускайте падающий тест, чтобы добиться успешного прохождения набора тестов.
## Коммиты и pull request
- Формулируйте заголовки коммитов в повелительном наклонении и не превышайте 72 символа.
- Ограничивайте каждый pull request одним изменением и указывайте в описании, как вы его проверили.
- Перед каждым коммитом запускайте линтер и тесты.
## Запрещено
- Никогда не добавляйте в коммиты секреты, API-ключи или файлы .env.
- Никогда не редактируйте вручную сгенерированные файлы в src/generated/; вместо этого создавайте их заново.
- Никогда не запускайте разрушающие команды для базы данных в production.
- Никогда не выполняйте force-push в main и не переписывайте общую историю.
Одно правило для пяти инструментов
---
description: Правила для файлов, соответствующих этому glob-шаблону
globs: app/**/*.tsx
alwaysApply: false
---
Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
---
applyTo: "app/**/*.tsx"
---
Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
---
paths:
- "app/**/*.tsx"
---
Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
---
paths:
- "app/**/*.tsx"
---
Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
---
trigger: glob
globs: app/**/*.tsx
---
Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
Как составить эффективный файл инструкций
Разместите точные команды в начале
В начале файла укажите реальные команды установки, тестирования и линтинга со всеми флагами. Точно назовите стек и версии, а там, где текст может быть неоднозначным, приведите короткий пример кода.
Чётко сформулируйте запреты
Прямо укажите, чего агент не должен делать, например изменять секреты, vendored-код или production. Самым распространённым полезным ограничением в рассмотренных GitHub файлах было «никогда не коммитить секреты».
Формулируйте проверяемые инструкции
«Запускай npm test перед коммитом» можно проверить, а «тестируй свои изменения» — нет. Устраните противоречия: если две строки расходятся, модель может выполнить любую из них.
Пишите кратко и разделяйте правила по путям
Anthropic рекомендует ограничивать файл 200 строками, а Cursor — каждое правило 500 строками. Перенесите инструкции для отдельной области в правило с ограничением по пути, чтобы оно загружалось только при работе с соответствующими файлами. Импорты упорядочивают файл, но не снижают стоимость контекста.
Не повторяйте то, что агент уже знает
В исследовании четырёх coding-агентов файлы контекста не обеспечивали стабильного повышения успешности выполнения задач и увеличивали стоимость инференса более чем на 20%. Файлы, написанные с помощью LLM, немного ухудшали результаты, а обзоры репозитория не помогали. Поэтому оставляйте в файле только неочевидные требования, например указания по конкретным инструментам.
Добавляйте правила, если ошибки повторяются
Начните с малого и добавьте правило, если агент повторит одну и ту же ошибку больше одного раза. Вместо того чтобы вставлять целое руководство по стилю, укажите существующий файл как образец.
Вопросы об AGENTS.md
Читает ли Claude Code файл AGENTS.md?
Да, начиная с v2.1.277. По умолчанию он читает AGENTS.md или .claude/AGENTS.md, только если в рабочей директории или выше нет CLAUDE.md, .claude/CLAUDE.md или CLAUDE.local.md. Параметр claude-md-and-agents-md загружает оба файла, а CLAUDE.md с директивой @AGENTS.md работает в любой версии.
Нужны ли файлу AGENTS.md frontmatter или определённые заголовки?
Нет. AGENTS.md — это обычный Markdown-файл без обязательных полей; заголовки можно выбирать любые. На сайте agents.md предлагаются такие разделы, как обзор проекта, команды сборки и тестирования, стиль кода, тестирование, заметки по безопасности и рекомендации для pull request.
Как использовать AGENTS.md в монорепозитории?
Разместите один AGENTS.md в корне, а другие — в пакетах, которым нужны собственные правила. Агенты читают файл, ближайший к редактируемому коду; при конфликте приоритет у него. Когда на сайте agents.md описали это, в основном репозитории OpenAI было 88 таких файлов.
Как настроить Gemini CLI на чтение AGENTS.md?
По умолчанию Gemini CLI по-прежнему использует GEMINI.md. Добавьте AGENTS.md в context.fileName в .gemini/settings.json, например ["AGENTS.md", "GEMINI.md"]. Выполните /memory show, чтобы проверить, что было загружено.
Какие coding-агенты поддерживают AGENTS.md?
Мы проверили документацию OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Devin Desktop, Cline и OpenClaw: все они читают этот файл напрямую. Для Gemini CLI и Aider нужна одна строка конфигурации. На сайте agents.md перечислены в общей сложности 23 совместимых инструмента, включая Zed, Warp, goose, opencode, Jules и JetBrains Junie.
Кто поддерживает формат AGENTS.md?
OpenAI передала AGENTS.md в Agentic AI Foundation — фонд под управлением Linux Foundation, о создании которого объявили 2025-12-09 одновременно с MCP и goose. По данным сайта agents.md, этот формат используют более 60k проектов с открытым исходным кодом.