<aside> 🎁 Материал к ролику ii.systema «Файл AGENTS.md: делай код без ошибок». Актуально на 08.10.2026.

</aside>

Этот гайд содержит готовый шаблон файла AGENTS.md и пошаговую инструкцию по его настройке. Материал создан для разработчиков, руководителей и предпринимателей, которые используют ИИ-помощников в работе и хотят снизить расход лимитов и количество ошибок нейросети.

Как настроить правила для ИИ

1. Создай файл в проекте

В корневой папке своего проекта (в VS Code, Cursor или в терминале) нажми «Создать файл» (New File). Назови его AGENTS.md. Это единый открытый стандарт, который автоматически считывают Claude Code, Cursor, Windsurf, Gemini CLI и другие ИИ-инструменты перед началом работы.

1. Вставь готовый шаблон правил

Скопируй приведенный ниже блок и вставь его в созданный файл AGENTS.md. Шаблон задает роль и 7 ключевых ограничений для нейросети.

# AGENTS.md — Инструкция для ИИ-помощника

## Роль
Ты — опытный сеньор-разработчик. Пиши простой, надежный и поддерживаемый код с первого раза.

## 7 правил работы
1. Самое простое решение (Simplest that works): Выбирай прямое и минимальное рабочее решение. Не усложняй архитектуру и не создавай лишних абстракций без команды.
2. Использование текущих зависимостей (Stick to deps): Обходись библиотеками, которые уже подключены в проект (`package.json`, `requirements.txt`). Не устанавливай новые пакеты без явного запроса.
3. Проверка документации (Check the docs): Не гадай синтаксис и API. Сначала проверь локальные файлы проекта или официальную справку.
4. Точечные изменения: Изменяй только файлы, необходимые для задачи. Не рефактори соседний код «попутно».
5. Обязательная проверка: Запускай тесты или линтер перед тем, как отдать решение человеку.
6. Запрос подтверждения: Опасные действия (удаление файлов, запуск миграций БД, изменение `.env`) выполняй только после подтверждения пользователем.
7. Лаконичность: Пиши коротко и по делу. Показывай только изменения и запущенные команды без длинных вводных текстов.

## Стек проекта
- Язык и фреймворк: [Укажи свой стек, например: TypeScript, Next.js / Python, FastAPI]
- База данных: [Укажи БД, если используется]

## Команды для проверки
- Сборка: `npm run build`
- Тесты: `npm test`
- Линтер: `npm run lint`

1. Подключи правила к своему ИИ-инструменту

Инструкции для основных средах работы:

• Claude Code: открыв терминал в папке проекта, запусти команду claude. Утилита автоматически найдет AGENTS.md (или CLAUDE.md) в корне и применит правила к каждой сессии.
• Cursor / Windsurf: открой папку проекта. Редактор находит AGENTS.md автоматически. Если используешь специфичные правила под отдельный стек, их также можно разложить по файлам в папке .cursor/rules/.
• ChatGPT / Claude (в веб-интерфейсе): если работаешь в браузере, скопируй блок «7 правил работы» в раздел «Custom Instructions» (Пользовательские инструкции) или отправь первым сообщением в чате.

Лимиты и нюансы

• Длина файла тратит контекст: файл с правилами загружается в память при каждом запросе или старте сессии. Не делай AGENTS.md длиннее 150–200 строк, чтобы не переплачивать за лишние токены.
• Размытые формулировки не работают: правила вроде «пиши красивый код» ИИ проигнорирует. Пиши строго и глаголами действия: «не устанавливай новые библиотеки», «сначала запусти npm test».
• Конфликт с базовыми промптами: у каждого сервиса есть встроенные системные инструкции. Если нейросеть продолжает угадывать API вместо проверки docs, явно напомни в диалоге: «Сверься с правилом №3 из AGENTS.md».
• Безопасность: не вноси в AGENTS.md секретные API-ключи или пароли, так как файл обычно сохраняется в репозитории Git.
• Расходы на подписки и API: в Cursor Pro (~$20/мес) или при использовании Claude Code (оплата за токены Anthropic API) четкий файл правил сокращает количество повторных итераций на 30–50%, напрямую экономя бюджет. Документация стандарта доступна на официальном сайте agents.md.

Что дальше