Основы · Блог

Зачем ИИ читают 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 не случайный:

  1. Читается и человеком, и моделью. Это plain text с минимальной разметкой: модель видит структуру, человек — документ без «обвязки».
  2. Заголовки — это навигация. Агенту проще работать с текстом, где есть # Сборка, # Тесты, # Правила.
  3. Дёшево по токенам. Никаких тегов и атрибутов — только содержимое.
  4. Живёт в 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