Основы · Блог
Зачем ИИ читают Markdown: AGENTS.md, CLAUDE.md и llms.txt
Что за файлы AGENTS.md и llms.txt в репозиториях и на сайтах, что в них писать и почему для инструкций ИИ выбран Markdown. Шаблон и FAQ.
# Зачем ИИ читают Markdown: AGENTS.md, CLAUDE.md и llms.txt
Рубрика «ИИ-контекст» · срез: ноябрь 2026
Если вы заглядывали в свежие репозитории на GitHub, могли заметить в корне файлы AGENTS.md или CLAUDE.md, а на некоторых сайтах — llms.txt. Общее у них одно: это инструкции и описания для ИИ-ассистентов, написанные обычным Markdown.
Разберёмся, что это за «документация для ИИ», что в ней пишут и почему для неё выбран именно .md. Если вы вообще первый раз слышите про Markdown — начните со статьи «Что такое Markdown и файл .md».
Коротко: три файла
| Файл | Где лежит | Кто читает | Что содержит |
|---|---|---|---|
AGENTS.md | корень репозитория | ИИ-агенты, работающие с кодом | инструкции: как собрать проект, чего не делать |
CLAUDE.md | корень репозитория | агент Claude Code | то же самое, для инструмента Anthropic |
llms.txt | корень сайта | ИИ-модели, чат-боты | описание сайта и ссылки на .md-версии страниц |
Теперь по каждому подробнее.
1. AGENTS.md — памятка агенту в репозитории
Конвенция, появившаяся в 2025 году: файл с инструкциями для ИИ-агентов, которые работают с кодом проекта. Идея простая — вместо того чтобы объяснять агенту одно и то же в каждой сессии, вы один раз описываете это в файле, и любой агент читает его сам.
Формат быстро поддержали крупные инструменты: агент Codex от OpenAI, Jules от Google, Cursor и другие. Для них AGENTS.md стал таким же стандартом входа, как README.md для человека.
Что обычно пишут:
- Как запустить проект: сборка, тесты, локальный запуск.
- Правила работы: что можно менять, а что трогать не стоит.
- Ограничения: не коммитить секреты, не тянуть лишние зависимости.
- Стиль: где лежат примеры, как называть файлы.
Минимальный рабочий шаблон:
# AGENTS.md
## Как запустить
npm install && npm run dev — сайт на localhost:3000
## Как проверять
npm run test — Vitest, около 10 секунд
## Правила
- не коммитить .env и содержимое data/secrets/
- менять только то, что указано в задаче
- после правок прогонять тестыДва практических совета:
- Держите файл коротким. Агент читает его в каждой сессии, и каждый килобайт — это токены. Инструкции уровня «будь старательным» не добавляют ничего.
- Пишите то, что нельзя вывести из кода. Не «у нас React» — агент это увидит сам. А вот «тесты запускаются так, данные лежат там, это не трогать» — ценная информация.
2. CLAUDE.md — та же идея у Claude Code
Claude Code — агент для терминала от Anthropic — использует свой файл: CLAUDE.md. Он грузится в контекст при старте каждой сессии, поэтому в нём пишут то, что агент должен знать всегда: структуру проекта, памятки, договорённости.
Функционально это тот же AGENTS.md под другим именем. Часть проектов держит оба файла, и один из них просто ссылается на второй — чтобы не поддерживать два текста. Содержательные правила из раздела выше применимы без изменений: коротко, конкретно, только не-выводимое.
3. llms.txt — документация сайта для моделей
Конвенция для сайтов, предложенная в 2024 году: в корень кладут файл с кратким описанием проекта и списком ссылок на Markdown-версии важных страниц — документация, changelog, справочник.
Зачем это нужно. Боты и ИИ-помощники берут контент с сайтов всё чаще, а HTML они читают «с мусором»: навигация, скрипты, баннеры. Заранее подготовленный .md-файл экономит усилия всем: модель получает чистый текст со структурой, а владелец сайта сам решает, что показать и как это сформулировать.
Почему именно Markdown
Инструкции для ИИ могли бы лежать в HTML, PDF или JSON. Выбор .md не случайный:
- Читается и человеком, и моделью. Это plain text с минимальной разметкой: модель видит структуру, человек — документ без «обвязки».
- Заголовки — это навигация. Агенту проще работать с текстом, где есть
# Сборка,# Тесты,# Правила. - Дёшево по токенам. Никаких тегов и атрибутов — только содержимое.
- Живёт в git. Правки инструкций видны в diff и обсуждаются как обычный код.
С чего начать
- Работаете с ИИ-агентом в своём проекте → заведите
AGENTS.mdпо шаблону выше. - Пользуетесь Claude Code →
CLAUDE.md; либо один файл со ссылкой на другой. - Хотите, чтобы ИИ точнее понимал ваш сайт → начните с маленького
llms.txt: название, описание, три-четыре ссылки на .md-версии. - Нашли у себя чужой
AGENTS.mdи хотите посмотреть, что в нём → это обычный .md, читается любым редактором.
FAQ
Это промпт? Не совсем. Промпт — разовая команда в диалоге. AGENTS.md и CLAUDE.md — постоянная документация: работает как README, просто его читатель — агент, а не человек.
Формат где-то стандартизован? Это конвенция, а не стандарт: жёсткой спецификации и валидатора нет. Работает договорённость « Markdown-файл с понятными заголовками», которую поддерживают основные инструменты.
Не опасно ли оставлять ИИ такие инструкции? Файл лежит в репозитории и читается только тем, кому вы и так дали доступ к коду. Ничего секретного в него писать не стоит — как и в любой файл в git.
Чем открыть .md-файл? Любым текстовым редактором. Если нужен удобный просмотр с разметкой и без установки тяжёлых программ — ProsaMD: офлайн-редактор для Windows и Linux размером около 4 МБ, который открывает .md двойным кликом. Скачать ProsaMD
Итог
Markdown перестал быть только разметкой README. Это формат, на котором ИИ-ассистенты получают инструкции (AGENTS.md, CLAUDE.md) и сайты отдают контент моделям (llms.txt). Хороший момент завести такой файл в своём проекте: один раз описали — и любой агент работает с проектом так, будто он здесь давно.
Попробуйте в ProsaMD
ProsaMD — бесплатный редактор и просмотрщик Markdown: открывает .md двойным нажатием и показывает заголовки, списки и таблицы как готовый документ. Бесплатно и открыто · установщик около 4 МБ · Windows и Linux