---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/agentsmd.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/agentsmd.md
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt

# Файл AGENTS.md

_`AGENTS.md`_ — файл с инструкциями и контекстом для агентов на основе искусственного интеллекта. Файл обычно находится в корне репозитория и служит аналогом `README.md` для агентов. Для монорепозиториев `AGENTS.md` можно поместить в каждый подпроект. В таком случае агенты будут отдавать приоритет инструкциям, которые находятся ближе всего к редактируемому файлу.

`AGENTS.md` не имеет четко определенной структуры и обязательных полей, его наполнение зависит от нужд проекта. Популярные варианты для наполнения файла:

* обзор проекта;
* команды для сборки и тестирования;
* рекомендации по стилю кода;
* инструкции по тестированию и контролю качества;
* правила оформления предложений изменений;
* требования безопасности.

AI-функциональность SourceCraft также учитывает контекст из `AGENTS.md`:

* При работе с Code Assistant в [режиме чата](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/code-assistant.md#chat-mode) в интерфейсе SourceCraft.
* При [генерации описания](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/code-assistant.md#description) для предложений изменений. Подробнее в разделе [Задать правила для описания](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/generate-description.md#rules).
* При [нейроревью](https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/code-assistant.md#review) предложений изменений.
* При работе с плагином Code Assistant для Visual Studio Code. Подробнее о том, как правила из `AGENTS.md` и другие пользовательские правила добавляются в контекст агента, подробнее на странице [Пользовательские правила в SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/chat-rules.md).

Подробнее об `AGENTS.md` в [репозитории проекта на GitHub](https://github.com/agentsmd/agents.md) и на [официальном сайте](https://agents.md/).

## Пример {#example}

```markdown
Telegram-бот для личных напоминаний и todo-задач. Бот запоминает сообщения пользователя и присылает уведомления в указанную дату и время.

## Технологический стек

* Python 3.12
* python-dotenv
* Aiogram 3.x (Telegram Bot API)
* SQLite + aiosqlite (хранилище задач и напоминаний)
* AsyncIOScheduler (планировщик задач)

## Стиль кода

* каждый handler — в отдельном файле в папке `bot/handlers/`.
* не пиши длинные функции > 40 строк.
* добавляй тесты для всех новых функций.
* добавляй комментарии для сложной логики.
* нельзя использовать `time.sleep()` — только `await asyncio.sleep()`.

## Запрещено

* предлагать переход на другие базы данных;
* предлагать переход на другие API.

## Команды для PR

* `/build` — сборка проекта;
* `/test` — запуск тестов;
* `/lint` — проверка стиля кода.
```