dotsagent.io
Язык:Русский
Инструкции · инструмент

Генератор AGENTS.md

Заполните форму, чтобы получить AGENTS.md с вашими командами, соглашениями и жёсткими ограничениями. Вы также получите одно правило с ограничением по путям для Cursor, GitHub Copilot, Claude Code, Cline и Devin Desktop, а также файлы-связки для инструментов, которые не подхватывают AGENTS.md по умолчанию.

Где каждый инструмент ищет файлы инструкций →

Начните с готового стека
Файлы-связки, указывающие другим инструментам на AGENTS.md
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 и не переписывайте общую историю.

Одно правило для пяти инструментов

Одно правило в пяти форматах; сохраните каждый файл по указанному над ним пути.

.cursor/rules/scoped.mdc
---
description: Правила для файлов, соответствующих этому glob-шаблону
globs: app/**/*.tsx
alwaysApply: false
---

Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
.github/instructions/scoped.instructions.md
---
applyTo: "app/**/*.tsx"
---

Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
.claude/rules/scoped.md
---
paths:
  - "app/**/*.tsx"
---

Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
.clinerules/scoped.md
---
paths:
  - "app/**/*.tsx"
---

Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.
.devin/rules/scoped.md
---
trigger: glob
globs: app/**/*.tsx
---

Следуйте шаблонам, уже используемым в соседних файлах этой папки. Для каждой экспортируемой функции добавьте docstring и тест в соответствующий файл тестов.

Как составить эффективный файл инструкций

Разместите точные команды в начале

В начале файла укажите реальные команды установки, тестирования и линтинга со всеми флагами. Точно назовите стек и версии, а там, где текст может быть неоднозначным, приведите короткий пример кода.

Блог GitHub, анализ более 2,500 файлов AGENTS.md

Чётко сформулируйте запреты

Прямо укажите, чего агент не должен делать, например изменять секреты, vendored-код или production. Самым распространённым полезным ограничением в рассмотренных GitHub файлах было «никогда не коммитить секреты».

Блог GitHub, анализ более 2,500 файлов AGENTS.md

Формулируйте проверяемые инструкции

«Запускай npm test перед коммитом» можно проверить, а «тестируй свои изменения» — нет. Устраните противоречия: если две строки расходятся, модель может выполнить любую из них.

Документация по памяти Claude Code

Пишите кратко и разделяйте правила по путям

Anthropic рекомендует ограничивать файл 200 строками, а Cursor — каждое правило 500 строками. Перенесите инструкции для отдельной области в правило с ограничением по пути, чтобы оно загружалось только при работе с соответствующими файлами. Импорты упорядочивают файл, но не снижают стоимость контекста.

Документация по памяти Claude Code; документация Cursor Rules

Не повторяйте то, что агент уже знает

В исследовании четырёх coding-агентов файлы контекста не обеспечивали стабильного повышения успешности выполнения задач и увеличивали стоимость инференса более чем на 20%. Файлы, написанные с помощью LLM, немного ухудшали результаты, а обзоры репозитория не помогали. Поэтому оставляйте в файле только неочевидные требования, например указания по конкретным инструментам.

Лаборатория SRI ETH Zurich, arXiv 2602.11988

Добавляйте правила, если ошибки повторяются

Начните с малого и добавьте правило, если агент повторит одну и ту же ошибку больше одного раза. Вместо того чтобы вставлять целое руководство по стилю, укажите существующий файл как образец.

Документация Cursor Rules; блог GitHub

Вопросы об 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 проектов с открытым исходным кодом.