~/guides/agents-md-vs-claude-md-vs-cursor-rules

AI Agents

AGENTS.md, CLAUDE.md, Cursor Rules: пять форматов инструкций для одного AI-агента

Как индустрия AI-коддинг-агентов пришла к пяти конкурирующим форматам конфигурации и что с этим сейчас практически делать.

К середине 2025 года у каждого AI-коддинг-инструмента появился свой файл с инструкциями для проекта: Cursor хотел .cursorrules, Claude Code — CLAUDE.md, GitHub Copilot — .github/copilot-instructions.md, Aider — CONVENTIONS.md. Серьёзный open-source репозиторий к 2026 году был вынужден держать четыре-пять почти одинаковых файлов, чтобы угодить всем агентам сразу.

Как это устроено сейчас

Весной 2026 года индустрия начала сходиться к одному открытому стандарту — AGENTS.md, который передан под управление Agentic AI Foundation при Linux Foundation и уже читается нативно более чем двадцатью инструментами: Cursor, Copilot, Codex CLI, Windsurf, Aider, Gemini CLI, Zed, Devin, Amazon Q и другими.

Формат Статус Кто читает нативно
AGENTS.md Открытый стандарт, Linux Foundation 20+ инструментов, растущий список
CLAUDE.md Проприетарный формат Claude Code Claude Code (главный holdout)
.cursor/rules/*.mdc Проприетарный формат Cursor Только Cursor
.github/copilot-instructions.md Формат Microsoft GitHub Copilot

Главное исключение — Claude Code

На середину 2026 года Claude Code остаётся основным крупным инструментом, который всё ещё в первую очередь читает собственный CLAUDE.md, а не универсальный AGENTS.md. Официальная рекомендация Anthropic для проектов, уже имеющих AGENTS.md, — не дублировать содержимое вручную, а держать тонкий мостик:

# CLAUDE.md

@AGENTS.md

Директива @AGENTS.md импортирует содержимое основного файла, оставляя CLAUDE.md местом для специфичных именно для Claude Code настроек — например, MCP-серверов или разрешений на выполнение команд.

Формат .mdc у Cursor — не просто markdown

В отличие от плоского AGENTS.md, файлы Cursor Rules требуют YAML frontmatter с полями globs (по каким путям применяется правило) и alwaysApply:

---
description: Frontend conventions
globs: src/**/*.tsx, src/**/*.ts
alwaysApply: false
---

Use functional components with hooks, not class components.

Ошибка в glob-паттерне здесь не выдаёт ошибку — правило просто молча не применяется к нужным файлам, и это одна из самых частых причин, по которой Cursor «игнорирует» явно прописанную конвенцию.

Практический подход на сегодня

Разумный дефолт 2026 года: AGENTS.md как единственный источник истины, тонкий мостик-файл для Claude Code через @AGENTS.md, и .cursor/rules/*.mdc добавляется только если реально нужно ограничение по конкретным путям файлов, а не по привычке. Держать четыре независимых, вручную синхронизируемых документа — рецепт того, что они неизбежно разойдутся между собой за пару месяцев.

Переписывать один формат в другой руками долго и легко ошибиться в структурных деталях каждого формата. AGENTS.md / CLAUDE.md / Cursor Rules Converter делает это автоматически, с поправкой на frontmatter .mdc и мостик-паттерн для CLAUDE.md.

Итоговый чеклист

AGENTS.md на середину 2026 года — самый широко поддерживаемый формат, разумная точка старта для нового проекта.

Claude Code — исключение, которое стоит явно поддержать через тонкий мостик-файл с директивой @AGENTS.md, а не через полное дублирование содержимого.

Файлы .mdc у Cursor требуют корректного YAML frontmatter — ошибка в glob-паттерне не выдаст ошибку, а просто молча не применит правило там, где вы этого ожидали.