Как ставить задачу ИИ-разработчику: уточнять, а не начинать заново

Задача

Эмре держит кафе в Кадыкёе и делает сайт с меню в Claude Code. Он пишет «сделай красиво», получает не то, пишет «нет, не так», потом «переделай всё». Через час у него три разных сайта и ни одного рабочего. Каждый раз Claude начинает с нуля, потому что не понимает, что именно не так. Эмре нужен способ ставить задачу так, чтобы её уточняли, а не переписывали.

Словарик.

• CLAUDE.md: файл в папке проекта с правилами, которые Claude Code читает в начале каждой сессии. Пишешь его ты.
• Контекст: всё, что Claude «держит в голове» в текущем разговоре: твои сообщения, прочитанные файлы, результаты команд. Чем он длиннее и запутаннее, тем хуже Claude следует инструкциям.

Шаги

1. Ставь задачу по формуле из четырёх частей.

   • Что сделать: одно действие. «Добавь блок меню».
   • Для кого: кто будет пользоваться. «Гости кафе, открывают с телефона из Instagram».
   • Как выглядит «готово»: как ты проверишь. «Открываю index.html на телефоне, вижу 3 раздела меню, цены в лирах, всё читается без увеличения».
   • Ограничения: чего нельзя. «Без новых библиотек, не трогай шапку и контакты». Последний пункт важнее, чем кажется. Без него Claude может «заодно улучшить» то, что уже работало.

2. Опиши проект один раз, в CLAUDE.md.

   • Набери /init: Claude Code изучит папку и создаст стартовый CLAUDE.md. Если файл уже есть, /init предложит улучшения, а не перезапишет его.
   • Допиши то, что Claude сам не узнает из файлов: язык сайта, для кого он, что запрещено.
   • Пиши конкретно и проверяемо: «цены только из menu.txt», а не «пиши аккуратно».
   • Держи файл коротким: по документации, меньше 200 строк. Длинный файл Claude выполняет хуже.
   • Проверить, что файл подхватился: команда /context, список Memory files.
   • Когда дописывать: Claude второй раз повторяет ту же ошибку, или ты второй раз пишешь одно и то же уточнение. ⚠️ CLAUDE.md это подсказки, а не замок. Важное («не читать .env») дополнительно закрывай настройками (урок 4.6). Пароли и токены в CLAUDE.md не пиши: файл попадёт в git.

3. Проси по одному шагу. Большую задачу сначала отдай в режиме Plan (урок 4.1): Claude покажет план по пунктам. Потом: «Сделай только пункт 1. Скажи, как проверить, и жди моего ок». Проверил → коммит (урок 4.9) → следующий пункт.

4. Описывай ошибку по схеме «скриншот + ожидала + получила».

   • Скриншот: в терминале вставь прямо в поле ввода; в приложении нажми + рядом с полем ввода или перетащи файл.
   • Что делал: «открыла на iPhone, нажала кнопку WhatsApp».
   • Что ожидал: «открывается чат с номером кафе».
   • Что получил: «пустая страница» или точный текст ошибки, скопированный целиком. «Не работает» без деталей обходится дороже всего: Claude будет гадать.

5. Уточняй, а не начинай заново.

   • Видишь, что Claude пошёл не туда? Жми Esc (в приложении кнопка остановки). Работа остановится, сделанное и разговор сохранятся, можно сразу уточнить. В приложении можно и не останавливать: напиши уточнение и нажми Enter.
   • Не понравился последний шаг? «Отмени это» или Esc Esc → Restore code (урок 4.1).
   • Не пиши «переделай всё». Пиши, что именно оставить и что изменить.
   • Исключение из правила: если ты поправил одно и то же больше двух раз, а всё равно не то, разговор засорён неудачными попытками. Тогда набери /clear и дай задачу заново, но уже точнее, с учётом того, что понял. Файлы проекта при этом остаются, начинается только новый разговор.

6. Проси доказательства. «Готово» от Claude ещё не доказательство. Проси: «покажи скриншот результата» или «скажи, что именно мне нажать, чтобы проверить».

Шаблон

Стартовый CLAUDE.md (впиши своё):

# Проект
Сайт кафе [название], [район, город]. Владелец: [имя], не программист.
Посетители: гости кафе, открывают с телефона.

# Правила
- Язык сайта турецкий. Проверяй ç, ğ, ı, İ, ö, ş, ü.
- Цены и тексты только из [menu.txt / content.txt]. Ничего не придумывай.
- Статический сайт: HTML и CSS, без фреймворков и новых библиотек.
- Объясняй простыми словами, по-русски.
- Одна задача за раз. После шага скажи, как проверить, и сделай git-коммит.
- Не открывай и не выводи .env. Секреты в код не вставляй.

Запросы для копирования:

1. Новая задача
Задача: [что сделать].
Для кого: [кто будет пользоваться].
Готово, когда: [что я увижу и где проверю].
Не трогай: [что уже работает].
Сначала план, жди моего «ок».

2. Сначала вопросы
Хочу [идея]. Прежде чем писать код, задай мне вопросы про то, о чём я могла не подумать. Потом запиши итог в SPEC.md.

3. Один шаг
Сделай только пункт [N] из плана. Остальное не трогай. Скажи, как проверить, и жди.

4. Точечная правка
В блоке [название] измени [что] на [что]. Больше ничего не меняй.

5. Ошибка
[скриншот]
Что делала: [действия].
Ожидала: [результат].
Получила: [результат или текст ошибки целиком].
Найди причину, объясни простыми словами, исправь и скажи, как проверить.

6. Не понравилось
Оставь [что нравится]. Измени только [что]. Почему: [что не так для гостя].

7. Объясни
Объясни простыми словами, что ты сейчас сделал и какие файлы изменил.

8. Проверка перед сохранением
Проверь сделанное: все ссылки и кнопки работают, на телефоне ничего не съезжает, турецкие буквы на месте. Покажи, что проверил. Потом сделай коммит.

9. Обновить правила
Ты второй раз [ошибка]. Добавь в CLAUDE.md короткое правило, чтобы это не повторялось, и покажи его мне.

10. Перезапуск после /clear
Контекст: [проект в 1-2 фразах]. Раньше пробовали [что], не подошло, потому что [почему]. Теперь задача: [точная формулировка по формуле].

Источники

• How Claude remembers your project (code.claude.com): CLAUDE.md: загружается в каждой сессии, /init (существующий файл не перезаписывает, а предлагает улучшения), /context → Memory files, меньше 200 строк, «context, not enforced configuration» (проверено 27.10.2026)
• Best practices (code.claude.com): конкретные запросы, вставка скриншота в запрос, Esc, Esc Esc / /rewind, /clear после двух неудачных исправлений, интервью и SPEC.md, просить доказательства
• Desktop quickstart · Desktop: кнопка остановки, уточнение через Enter без остановки, вложения через + или перетаскивание, /context в приложении
• Quickstart (code.claude.com): «be specific», пошаговые инструкции