К этому моменту вы уже несколько раз общались с агентом в чате. И наверняка заметили: стоит начать новый чат, и агент забывает все. Какой у вас проект, на чем он написан, какие библиотеки вы используете. Каждый раз приходится заново объяснять контекст, и это быстро надоедает.

Так устроены все ИИ-агенты: каждый чат — отдельный разговор. У агента нет памяти между сессиями. Но есть простой способ это обойти.

Записка для помощника без памяти

Представьте, что у вас есть помощник, который каждое утро приходит на работу и не помнит вчерашний день. Вы бы написали ему записку: «Прочитай перед началом работы». В записке — что за проект, какие технологии, какие правила. Помощник читает, входит в курс дела и работает нормально.

С ИИ-агентом можно сделать то же самое. В корневой папке проекта — это главная папка, в которой лежат bot.py и requirements.txt — нужно создать текстовый файл-инструкцию. Агент будет читать его автоматически при каждом новом чате. Когда вы отправите вопрос в новом чате, агент сначала прочитает файл и сразу поймет контекст: что вы разрабатываете, какие библиотеки используете, какие правила соблюдаете. Ничего не нужно объяснять заново.

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

Что писать в AGENTS.md

Главное правило — конкретность. Общие фразы вроде «пиши чистый код, следуй лучшим практикам» не дают агенту ничего полезного. Он и так старается писать чистый код. Ему нужны факты о вашем проекте.

Вот пример файла для нашего Telegram-бота:

# Проект: Telegram-бот для расшифровки голосовых сообщений ## Стек - Python 3.10+ - python-telegram-bot (асинхронный) - Deepgram API для распознавания речи ## Структура - bot.py -- основной файл бота - requirements.txt -- зависимости - .env -- секреты (TELEGRAM_TOKEN, DEEPGRAM_API_KEY) ## Правила - Секреты всегда брать из .env, никогда не хардкодить - Бот…