AGENTS.md и файлы правил: как задать границы агенту

AGENTS.md — это Markdown-файл с инструкциями для агента программирования: какие изменения делать, каким соглашениям следовать и как проверять результат. CLAUDE.md и правила Cursor решают похожую задачу, но загрузка и сочетание файлов зависят от клиента. Такой файл направляет действия агента, а доступ к диску и сети ограничивается отдельно: см. соглашение AGENTS.md и различие между инструкциями и разрешениями.

Что можно задать в правилах

Запишите сведения о проекте: назначение каталогов, принятые команды проверки, запрет на изменение сгенерированных файлов и требования к ревью. AGENTS.md — обычный Markdown без обязательной схемы конфигурации; назначение и размещение описаны в руководстве по соглашению.

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

# Правила проекта

- При исправлении корзины меняй только src/cart/ и tests/cart/.
- Перед изменениями зафиксируй git status и сохрани чужую работу.
- Не меняй манифесты зависимостей, lock-файлы, биллинг и развёртывание.
- Не читай файлы учётных данных и не отправляй код во внешние сервисы.
- Если нужен другой путь, объясни причину и запроси расширение задачи.
- Запусти существующие тесты корзины, укажи команду и результат.
- В конце покажи изменённые пути, неопределённости и diff для проверки.

Разделяйте постоянные соглашения проекта и текущее поручение. Первые удобно хранить в файле, а конкретную ошибку, допустимые пути и пример приёмки — в задании. Например: удаление последнего товара оставляет пустую корзину и не меняет поведение оформления заказа.

Проверяйте правила как код. Каждая полезная инструкция должна описывать наблюдаемое действие, путь или доказательство для ревьюера. Вместо общей просьбы соблюдать осторожность укажите конкретное ограничение. Другие объяснения собраны в разделе об AI-агентах.

Какие инструменты читают какие файлы

По состоянию на 30 октября 2026 года ориентируйтесь на следующую схему и проверяйте поведение установленного клиента:

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

Какие правила имеют приоритет

Единой иерархии для всех продуктов нет:

• Codex: сначала загружаются глобальные инструкции, затем файлы от корня проекта к рабочему каталогу. В одном каталоге AGENTS.override.md проверяется раньше AGENTS.md; включается только один файл. Более локальные инструкции переопределяют предыдущие. Порядок поиска.
• Cursor: вложенные AGENTS.md дополняют родительские; более конкретные инструкции имеют приоритет. Для отдельных типов правил порядок такой: Team Rules, Project Rules, User Rules. Иерархия Cursor.
• Claude Code: содержимое CLAUDE.md объединяется, а не заменяется. Если прямая поддержка AGENTS.md доступна, по умолчанию он выбирается при отсутствии подходящего CLAUDE.md или CLAUDE.local.md. Противоречия следует устранять. Загрузка инструкций.

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

Как подключить безопасно

Здесь подключение означает передачу инструкций клиенту, а не установку сервера.

1. Откройте нужный проект в VS Code или своём редакторе. Проверьте рабочую папку и каталог терминала. До правок зафиксируйте изменённые и неотслеживаемые пути; для эксперимента с неопределёнными последствиями используйте отдельную рабочую копию.
2. Прочитайте существующие инструкции. Проверьте корневые правила и файлы нужных каталогов. Сохраните локальные дополнения. Устраните противоречия в границах задачи до разрешения записи.
3. Выберите документированный формат клиента. Используйте AGENTS.md там, где он поддерживается. В Claude Code общие инструкции можно подключить импортом @AGENTS.md. В Cursor осознанно выбирайте обычный Markdown или структурированные правила: форматы различаются. Следуйте документации из таблицы.
4. Убедитесь, что инструкции загрузились. В Claude Code проверьте Memory files командой /context. В Codex попросите перечислить активные источники из нужного каталога; после изменения инструкций перезапустите сеанс. См. руководство Claude Code и руководство Codex.
5. Отдельно настройте реальные ограничения доступа. Начните с ограниченной рабочей области и явного согласования чувствительных инструментов. В Claude Code управление доступом доступно через /permissions; текст CLAUDE.md разрешения не меняет. См. документацию разрешений и практику разрешений MCP.
6. Проведите ограниченную пробу и проверьте доказательства. Поручите исправление корзины с указанными допустимыми путями. Посмотрите фактически изменённые файлы и вывод тестов. Если потребовалось расширение, согласуйте его до продолжения. Сохраните diff для ревью человеком.

Когда это не работает

Запрет остаётся текстом. Инструкция не развёртывать приложение не отключает инструмент развёртывания и не отзывает его учётные данные. Разрешения и изоляцию настраивают в среде выполнения; нужно проверять их фактическое действие. Руководство Claude Code отделяет механизмы контроля от инструкций.

Файл не загрузился. В Codex результат поиска зависит от каталога запуска. В Cursor применение правила проекта может зависеть от пути или ручного подключения. Сначала проверьте поиск Codex и режимы применения Cursor.

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

Убедительный отчёт подменяет проверку. Запросите diff и вывод нужных команд, затем изучите их. Сообщение об успешных тестах не заменяет результат запуска. О границах таких свидетельств подробнее рассказано в статье что доказывает квитанция задачи.

Где здесь Tvijo

Впишите правила проекта в описание задачи Tvijo: заранее задайте допустимую работу, инструменты и критерии приёмки. Для корзины укажите пути из примера и необходимость согласования перед изменением биллинга. Это практическая граница поручения; само имя AGENTS.md не создаёт принудительно ограниченный список файлов. См. разрешения и движение данных Tvijo.

По состоянию на 30 октября 2026 года важно различать способы работы. Расширение DSHREM для VS Code передаёт выбранный контекст в задачу Tvijo; опубликованное сравнение редакторов описывает локальные инструменты и режимы согласования. Проверьте канал установленной сборки и режим. TvijoCode включает расширение в тестовую сборку редактора; опубликованное руководство описывает неподписанные Windows-сборки без автоматического обновления.

Tvijo MCP позволяет совместимому клиенту обращаться к Tvijo. Опубликованная консультация, подготовленное ревью переданного diff с ожидающей публикацией пакета и запланированные интеграция с редактором и делегирование — разные возможности. Подключение MCP само по себе не даёт Tvijo общего контроля над рабочими файлами клиента.

В рабочем пространстве Tvijo по состоянию на 31 октября 2026 года план Try стоит $0: до 50 задач, 100 000 токенов или $0.05 спонсируемого использования — до достижения любого из этих пределов. Действует общий дневной пул $1, который финансирует TVIJO. Для Service credit указано $10: это запрос предоплаченного кредита с оплатой фактического использования и сервисной наценкой 8%. Приём платежей не активирован; создание заказа не означает списания денег.

Частые вопросы

AGENTS.md обеспечивает безопасность?

Он описывает политику, но не ограничивает доступ самостоятельно. Дополните его разрешениями инструментов и ограничениями среды, затем проверяйте изменения.

Нужно ли хранить CLAUDE.md вместе с AGENTS.md?

Если этого требуют клиенты, держите общие инструкции в одном месте и используйте документированный импорт. Проверьте загрузку и избегайте противоречащих копий.

Может ли вложенный файл расширить границы задачи?

Рассматривайте расширение как отдельное решение. Согласуйте его до правок, а реальные разрешения меняйте отдельно, если этого требует разрешённая работа.