Как писать промпты для Claude Code: канон сильного запроса

Коротко

Почему агент выдаёт кашу - дело не в модели

Дело не в модели.

Самая частая жалоба, которую я слышу на воркшопах: «я попробовал, он чушь выдаёт». Разбираемся - и почти всегда оказывается, что человек написал «сделай мне пост на эту тему» или «напиши стратегию» и ждал чуда. Модель не телепат. Она собрала общий ответ на общий вопрос.

У меня для этого есть короткая формула, которую я повторяю на каждом обучении: качество твоего вопроса равно качеству ответа. Многие говорят «сделай мне пост» и получают ерунду. А описать задачу чётко - людям лень. В этой лени и прячется весь разрыв между теми, у кого ИИ работает, и теми, у кого «не взлетело».

Разберём простым языком. Промпт - это не заклинание, которое надо угадать. Промпт - это брифинг новому сотруднику. Представь, что к тебе вышел толковый стажёр: способный, быстрый, но про твой бизнес не знает ничего. Если ты скажешь ему «сделай красиво» - он сделает по-своему. Если положишь бриф с ролью, задачей, цифрами и примером - принесёт то, что нужно, с первого раза. С ИИ-агентом ровно так же.

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

И вот тут самое интересное: этому можно научиться за один вечер. Есть канон - набор деталей, из которых собирается сильный запрос. Дальше по нему.

Канон промпта: 7 деталей сильного запроса

Я объясняю структуру запроса через образ сборочной линии: есть роль - ты эксперт по маркетингу; задача - сделать стратегию; контекст - для фитнеса; метрики - бюджет до 10 тысяч долларов; дальше ограничения и формат ответа. Это как сборочная линия - каждый элемент играет свою роль. Убери одну деталь - изделие поедет кривым.

Вот полный канон. Шесть деталей работают в любой нейросети, седьмая критична именно для агента, который не отвечает, а действует.

Седьмая деталь - моя добавка именно для работы с агентом, и она меняет всё. Обычный чат отвечает и замолкает. Агент работает сам: читает файлы, пишет код, запускает команды. Если не сказать ему, где финиш, он остановится там, где результат «выглядит готовым» - а это не то же самое, что «работает». Дай проверяемый критерий - и агент сам себя доведёт до него.

Официальная документация Claude Code говорит ровно то же, только другими словами.

Хорошая новость: канон не надо держать в голове. Он ложится в один шаблон.

Готовый шаблон промпта, который можно скопировать

Вот рабочий каркас. Он выглядит длинным, но заполняется за минуту - особенно если диктовать голосом, а не печатать.

Роль: ты [кто, эксперт в какой области].
Задача: [глагол действия + что именно сделать + зачем].
Контекст: [что за проект, что уже есть, какие детали важны].
Цифры: [бюджет, сроки, размеры, лимиты - всё измеримое].
Ограничения: [что делать НЕ нужно, чего избегать].
Формат ответа: [план / таблица / код / текст; сначала план, код после утверждения].
Критерий «сделано»: [по какому признаку понятно, что задача закрыта].
Если чего-то не хватает - не выдумывай, задай мне уточняющие вопросы.

Последняя строка - не украшение. Модель по своей природе очень хочет ответить и не разочаровать тебя, поэтому, когда данных не хватает, она достраивает их сама - и так рождаются красивые выдумки. Строчка «не хватает - спроси» разворачивает её от фантазии к вопросу.

Сравни на живом примере, что даёт каждый подход.

Левая колонка запускает лотерею. Правая - управляемый результат. При этом ты не написал ни строчки кода: ты выступил заказчиком, который умеет ставить задачу. Это ровно тот навык, о котором я говорю в гайде про 12 принципов вайбкодинга - ты архитектор, а не исполнитель.

Четыре уровня запроса: от вопроса до управленческого брифа

Канон не обязательно раскрывать целиком с первого слова. Есть лестница из четырёх ступеней - я показываю её на каждом воркшопе, и после неё у людей щёлкает.

1. Уровень 1. Вопрос

   «Как разработать маркетинговую стратегию?» - получишь общие советы ни о чём.

2. Уровень 2. Задача

   «Разработай стратегию для фитнес-приложения» - появляется отрасль и каналы.

3. Уровень 3. Задача + контекст

   «...для мужчин 25-35 лет, бюджет 10 тысяч долларов» - появляются сегменты, KPI, логика.

4. Уровень 4. Управленческий бриф

   «Ты эксперт по маркетингу. Разработай... включи каналы и план действий. Результат дай таблицей» - детальный план с ролью, ограничениями и форматом.

Разница между первым и четвёртым уровнем - это разница между «что-то общее» и «готово к работе». Главный вывод, который я даю аудитории: ответ зависит не только от модели, но и от качества постановки задачи. Для рабочих задач стремись к уровню 3-4.

Заметь: четвёртый уровень - это и есть наш канон, просто собранный в живую фразу. Роль, задача, контекст, цифры, формат - всё на месте.

Промпт-инжиниринг умер? От формулировки к контексту

Пару лет назад все учились «правильно формулировать промпт»: волшебные слова, хитрые обороты. Сегодня это уже почти неважно.

Если коротко, суть такая. Раньше был важен навык промпт-инжиниринга - сейчас важнее контекст-инжиниринг. Модели любой нормальный промпт уже понимают, а вот контекст важно правильно предоставить. Мы переходим от «как красиво спросить» к «что положить агенту перед глазами».

Секрет не в промпте, а в том, что ты положишь в папке. Это звучит буднично, но это и есть методология, которую почти никто из работающих с ИИ-агентами не использует - и упирается в потолок «модель тупая». Модель не тупая. Ей просто не дали контекст.

На практике это значит вот что. Ты один раз заводишь для проекта файлы-инструкции: кто ты, что за продукт, какие правила, что уже сделано. Агент читает их сам перед каждой задачей и работает как сотрудник, который знает карту офиса, а не как случайный человек с улицы. Промпт при этом становится коротким - потому что половина контекста уже лежит в папке. Подробно этот механизм я разбираю в гайде про контекст-инжиниринг и второй мозг.

Спасательные промпты: что писать, когда агент застрял

Бывает так: запрос сильный, а агент всё равно буксует. Зациклился, чинит одно и ломает другое, или выдаёт ответ с уверенностью, которой ты не доверяешь. Это нормально. На такие моменты у меня есть три спасательных промпта - держи их под рукой.

Первый - «прожарь свой ответ». Самый простой лайфхак: после ответа напиши «прожарь свой ответ» или «проверь себя, ты уверен, что это соответствует действительности?». Практически всегда агент сам начинает себя критиковать. Если запрос был сильным - он поставит себе четыре с половиной из пяти и оставит как есть. Если слабым - сильно покритикует и переделает. Ты бесплатно получаешь второе мнение от того же агента.

Второй - «я застрял». Универсальная выручалка на любой технический затык. Копируешь шаблон:

У меня ошибка: [вставь текст ошибки или опиши словами].
Объясни простыми словами, что это и почему так происходит.
Можешь исправить сам - исправляй.
Нужны мои действия - дай по одному шагу за раз.

Этот промпт снимает панику непрограммиста. Ты не обязан понимать ошибку - твоя задача передать её агенту структурно: что делал, что ждал, что получил. Дальше он либо чинит сам, либо ведёт тебя за руку по одному шагу.

Третий - «назови три гипотезы». Он для случая, когда агент застрял в цикле: чинит, не помогает, чинит снова то же место. Тут нельзя давать ему латать дальше - надо заставить остановиться и подумать вслух:

Ты чинишь эту ошибку по кругу, и не помогает. Стоп.
Не исправляй прямо сейчас. Сначала назови три РАЗНЫЕ гипотезы,
почему это происходит, и как проверить каждую по отдельности.
Начни с самой вероятной. Потом проверим по одной.

Приём заставляет агента разорвать цикл и вернуться к корневой причине вместо латания симптома. Это та же логика, что в премортеме, только для отладки: сначала версии, потом действие.

Заметь общую логику всех трёх: ты не давишь на агента и не злишься. Ты меняешь постановку задачи. Как говорится, если на пути забор - надо его обойти, а не биться в него лбом.

Частые вопросы

Главный вывод

Сведём в одну мысль. Промпт для агента - это не магическое заклинание, которое надо угадать. Это брифинг: роль, задача, контекст, цифры, ограничения, формат и критерий «сделано». Собери его по канону - и получишь результат с первого-второго захода, а не с пятнадцатого. Застрял - не бейся в стену, а смени постановку: «прожарь свой ответ», «я застрял, объясни по шагам», «назови три гипотезы».

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

Как думаешь: канон промпта - это временный навык, который через год возьмут на себя сами модели, или базовая грамотность, которая останется с нами надолго, как умение гуглить?

Если хочешь не просто прочитать про это, а собрать систему работы с ИИ под свою команду - я провожу интенсив по нейросетям для бизнеса: без магии, по делу, с результатом, который остаётся у вас.