CLAUDE.md и формула задачи

Claude Code работает тем лучше, чем понятнее ты объясняешь. Есть два инструмента, которые резко поднимают качество: CLAUDE.md — постоянная памятка о проекте, и формула задачи — как формулировать запрос, чтобы получать нужное с первого раза.

🎯 После урока сможешь: написать CLAUDE.md и научиться ставить задачу по формуле.

CLAUDE.md — «мозг» проекта

CLAUDE.md — это обычный текстовый файл в корне проекта. Claude Code читает его при каждом запуске и держит в голове. Один раз описал проект — и не повторяешь это в каждом задании.

Структура CLAUDE.md: название проекта с кратким описанием, раздел «Стек» (язык, библиотеки, база данных), раздел «Структура» (какие папки и файлы за что отвечают), раздел «Правила» (секреты в .env, обработка ошибок), раздел «Ограничения» (что не делать). Секреты сюда не пишут — только в .env.

В CLAUDE.md не пишут секреты (токены, ключи) — только правила и контекст. Секреты живут в .env (об этом — следующий урок).

Формула задачи: контекст → задача → ограничения → критерии

Размытая просьба даёт размытый результат. Хорошее задание строится по формуле из четырёх частей: контекст (что за проект), задача (что сделать), ограничения (чем пользоваться и чем нет), критерии (когда считать готовым).

Плохо: «Напиши бота». Хорошо: «Проект — бот сбора заявок для онлайн-школы (контекст). Сделай приём заявки и уведомление админу (задача). Только aiogram и SQLite, токен из .env (ограничения). Готово, когда заявка приходит админу (критерий)».

Контрольный вопрос. Какой запрос составлен по формуле «контекст → задача → ограничения → критерии»?

А«Напиши мне бота на Python, чтобы всё работало и выглядело красиво, и побыстрее, я тороплюсь.»
Б«Бот заявок для школы. Сделай приём заявки и уведомление админу. Только aiogram и SQLite. Готово, когда заявка дошла.»
В«Сделай что-нибудь полезное для школы, сам реши как и на чём писать, потом покажешь результат.»

Подсказка: Ищи запрос, где есть все четыре части: контекст, задача, ограничения, критерий готовности.

Онлайн-проверка ответа появится позже

Контрольный вопрос. Что уместно записать в CLAUDE.md? Отметь всё верное.

Выберите все верные варианты.

АСтек проекта (язык, библиотеки, база данных)
БПравила кода и ограничения (что НЕ делать)
ВПолный текст всех файлов проекта целиком
ГСтруктуру проекта (папки, ключевые файлы)
ДРеальный API-ключ и токен бота
ЕИсторию всех команд, которые ты вводил за день

Подсказка: Секреты в памятку проекта не пишут — им место в .env.

Онлайн-проверка ответа появится позже

Контрольный вопрос. Заказчик просит: «Собери мне бота для доставки цветов, он должен принимать заказ и сообщать флористу». Каких частей формулы «контекст → задача → ограничения → критерии» здесь не хватает, чтобы получилось полноценное задание для Claude Code? Отметь всё верное.

Выберите все верные варианты.

АОграничения — не хватает (не сказано, чем пользоваться и чем нет)
БКонтекст — не хватает (в просьбе не назван проект)
ВКритерии — не хватает (не сказано, когда считать работу готовой)
ГЗадача — не хватает (не сказано, что должен делать бот)

Подсказка: Контекст и задача в просьбе уже есть — перечитай и найди, о чём там нет НИ СЛОВА.

Онлайн-проверка ответа появится позже

Приём для однообразных ответов. Если Claude Code раз за разом предлагает один и тот же ход решения — попроси сразу несколько: «Предложи 3 разных варианта и укажи, какой ты бы выбрал и почему». Модель по умолчанию тянется к «среднему» варианту — прямой запрос вариантов ломает эту привычку и даёт тебе выбор, а не единственное решение без альтернатив.

Что дальше

Теперь Claude Code понимает проект (CLAUDE.md) и получает от тебя чёткие задания (формула). Осталось важнейшее правило, с которого начинается любой боевой проект, — безопасность и секреты. Об этом следующий урок.

← Назад  ·  ↑ В начало урока  ·  ⌂ В начало курса  ·  Вперёд →

Школа Виктора Комлева