Создаем документацию, чтобы ИИ помнил контекст

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

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

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

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

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

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