Контекст: файл правил и MCP
Урок 20 из 26 курса «Вайбкодинг: курс с нуля». Бесплатно, с анимациями и тестом.
Агент забывает всё
Вчера ты объяснил агенту, как устроен твой трекер тренировок. Сегодня новая сессия, и он снова ничего не знает. Контекст: всё, что агент видит прямо сейчас, то есть твоё сообщение, открытые файлы и инструкции. Между сессиями он обычно ничего не помнит. Решение простое: записать главное в файл внутри проекта. Агент сам читает его в начале работы. Он слева на схеме.
AGENTS.md и его родня
AGENTS.md: открытый формат, обычный текстовый файл в корне проекта, то есть в его главной папке. Его читают многие агенты. Claude Code читает свой CLAUDE.md, у Cursor свои файлы правил. Смысл везде один: памятка для нового сотрудника. Окончание .md значит Markdown, простой текст с заголовками и списками. Можно вести один файл, а в остальных просто сослаться на него.
Что туда писать
Четыре строки на схеме: база. Проект: одна фраза, что это и для кого. Запуск: команда, которой сайт стартует у тебя, например npm run dev. Тесты: команда проверок, например npm test. Никогда: ключи в коде, коммиты прямо в main. Можно добавить стиль: «понятные названия, тексты на русском». Это как записка сменщику на подработке: коротко и по делу.
Коротко и правда
Файл на десять экранов вредит: он съедает контекст, и важное теряется среди мелочей. Неправдивый ещё хуже. Написано npm start, а проект запускается через npm run dev? Агент будет раз за разом ошибаться. Поменял что-то в проекте: обнови файл или попроси агента «обнови AGENTS.md по итогам». И никаких ключей там: файл лежит в Git, а Git помнит всё.
MCP: розетки для агента
MCP (Model Context Protocol): стандартный способ подключать к агенту сервисы и инструменты. Как USB: одна форма разъёма, много разных устройств. На схеме справа три вилки. GitHub: агент читает задачи и PR. База: смотрит таблицы с данными. Браузер: сам открывает твой сайт и нажимает кнопки. Каждое такое подключение называют MCP-сервером.
Подключай с умом
MCP-сервер получает доступ ко всему, что ты ему открыл. Ставь только проверенные: от самого сервиса или известных проектов. Давай минимум прав: к базе только чтение и лучше к тестовой копии, а не к реальным данным пользователей. Ловушка: текст, который агент читает через MCP, например страница сайта, может прятать команды для ИИ. Поэтому рискованные действия всё равно одобряешь ты.
Проверь себя
- Зачем в проекте файл AGENTS.md?
Правильный ответ: Агент читает его и узнаёт правила проекта. Агент забывает между сессиями, а файл правил даёт ему главное: что за проект, как запускать, что нельзя. Ключи туда класть нельзя: файл в Git. - Что такое MCP?
Правильный ответ: Стандарт подключения сервисов к агенту. MCP как USB для агента: одним способом подключаются GitHub, база, браузер и другие инструменты. - Подключаешь агенту базу данных через MCP. Как правильно?
Правильный ответ: Дать минимум прав: например, только чтение. Чем меньше прав, тем меньше вреда от ошибки агента или спрятанной команды. Лучше тестовая копия, а не реальные данные пользователей.