Каждое утро ты открываешь новую сессию и снова объясняешь агенту: «это бот онлайн-школы, пиши на Python, токен бери из .env, ничего не удаляй без спроса». На третий день забываешь половину, и агент добавляет библиотеку, которую Ольга просила не трогать. Это лечится одним файлом и одной привычкой.
Чему научишься в этом уроке:
• написать CLAUDE.md, памятку о проекте для агента;
• ставить задачу по формуле «контекст → задача → ограничения → критерии»;
• проверять, что агент следует памятке.
CLAUDE.md: памятка проекта
CLAUDE.md: обычный текстовый файл в корне проекта, то есть в самой папке, которую ты открыл в Claude Code. Агент читает его при каждом запуске. Как памятка для нового сотрудника: один раз записал правила, и не повторяешь их в каждом поручении.
Черновик соберёт сам агент. Напиши в сессии команду /init: он обойдёт папку и запишет, как запускается проект и как он устроен. Или попроси словами: «Создай CLAUDE.md: что это за проект, на чём написан, какие правила соблюдать». Потом допиши то, чего агент знать не может: для кого проект и чего делать нельзя.
Разделы, которые стоит держать:
- Описание: 1–3 предложения, что делает проект и для кого.
- Стек: язык, библиотеки, где хранятся данные.
- Структура: какие папки и файлы за что отвечают.
- Правила: секреты только в .env, ошибки не замалчивать, комментарии на русском.
- Ограничения: чего не делать, например не добавлять библиотеки без спроса.
- Команды: как запустить программу и проверки.
Так может выглядеть короткая памятка для твоего первого проекта:
# Проект: приветствие и счётчик дней
## Описание
Учебная программа: спрашивает имя и пишет, сколько дней до Нового года.
## Стек
- Python, без сторонних библиотек
## Правила
- Комментарии и сообщения пользователю на русском
- Ошибки ввода не замалчивать, а переспрашивать
## Ограничения
- Не добавлять библиотеки без спроса
- Не удалять файлы без спроса
## Команды
- Запуск: py main.pyВ CLAUDE.md не пишут ключи, токены и пароли. Файл попадает в git и на GitHub вместе с кодом. Где хранить секреты, разберём в уроке 1.6.
Держи памятку короткой. Агент перечитывает её целиком при каждом запуске, и длинный файл с десятками правил он выполняет хуже, чем короткий из главного.
Формула задачи
Размытая просьба даёт размытый результат. Задача из четырёх частей почти всегда получается с первого раза:
- Контекст: что за проект и для кого.
- Задача: что сделать.
- Ограничения: чем пользоваться и чем нет.
- Критерии: по чему ты поймёшь, что готово.
Плохо: «Напиши бота».
Хорошо: «Проект: бот заявок онлайн-школы «Кодиум» (контекст). Сделай приём заявки: имя, контакт, курс (задача). Только Python, без новых библиотек, кроме библиотеки для Telegram (ограничения). Готово, когда тестовая заявка приходит администратору и сохраняется в файл (критерий).»
Критерий важнее всего: по нему ты проверяешь работу, а агент проверяет себя. В прогоне практики фундамента агент получил задание с явными критериями, сам написал 14 проверок, запустил их, нашёл и починил ошибки и сдал работу без ручных правок.
Если агент раз за разом предлагает одно и то же решение, попроси выбор: «Предложи 3 разных варианта и скажи, какой выбрал бы ты и почему».
Длинную задачу не отдавай целиком. Например, «изучи пять конкурентов школы и предложи цены» агент сделает за один раз поверхностно. Разбей её на шаги и заведи общий файл brief.md: цель, что уже известно, что решили. Каждый шаг начинается словами «прочитай brief.md» и заканчивается «допиши в brief.md, что нашёл». После шага посмотри результат сам и только потом давай следующий: ошибку первого шага так видно сразу, а не в конце цепочки.
Если не получилось
- Агент не следует правилу из CLAUDE.md. Проверь, что файл лежит в корне папки проекта, а не во вложенной папке, и начни новую сессию: памятка читается при запуске.
- /init перезаписал твой текст? Обычно он предлагает дополнения к уже существующему файлу. Если что-то пропало, верни прошлую версию через git, как в уроке 1.4.
- Памятка разрослась. Убери то, что агент и так видит по файлам, оставь правила и ограничения.
Контрольный вопрос. Заказчик пишет: «Собери бота для цветочного магазина, он должен принимать заказ». Чего не хватает, чтобы это была задача по формуле? Отметь всё верное.
Выберите все верные варианты.
Подсказка: Задача в просьбе есть. Чего ещё нет из четырёх частей?
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Контрольный вопрос. Ты третий раз пишешь агенту «не добавляй библиотеки без спроса». Что сделать, чтобы больше не повторять?
Подсказка: Какой файл агент читает при каждом запуске?
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Контрольный вопрос. Что из этого нельзя записывать в CLAUDE.md?
Подсказка: CLAUDE.md уходит в git вместе с кодом.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Задание. МИССИЯ «Памятка и задача по формуле». 1. В папке moy-pervyy-proekt создай CLAUDE.md командой /init и допиши разделы «Описание», «Правила», «Ограничения», «Команды». Добавь правило, которое легко проверить, например «в начале каждого нового файла пиши комментарий на русском, что он делает». 2. Начни новую сессию и дай одну задачу по формуле (например, вывести число дней до лета отдельной функцией). 3. Сохрани результат коммитом. Принято, если: приложен файл CLAUDE.md с четырьмя разделами и без ключей; текст задачи, где подписаны все четыре части формулы; снимок или файл, по которому видно, что агент выполнил проверяемое правило; снимок git log —oneline с новым коммитом.
Подсказка: Проверяемое правило выбирай такое, которое видно глазами в файле, а не «пиши хороший код».
✅ Готово, если: программа запускается без ошибок и выводит то, что просят в задании.
На курсе задания проверяются автоматически. Решить первое задание бесплатно → · Подобрать курс
Что дальше
Агент знает проект и получает понятные задачи. Дальше идёт безопасность: в уроке 1.6 разберём, где хранить ключи и токены, чтобы они не попали в код, в git и к посторонним.
Итог:
• CLAUDE.md в корне проекта хранит описание, стек, правила, ограничения и команды, без секретов;
• задача по формуле содержит контекст, задачу, ограничения и критерии;
• правило памятки ты проверил на новой сессии и сохранил результат коммитом.
