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

Как писать промпты для Claude Code и любого ИИ-агента: канон из 7 деталей, готовый шаблон плюс три спасательных промпта, когда агент застрял.

URL: https://posts.danashkin.ru/guides/kanon-prompta-dlya-ai-agenta
Обновлено: 2026-08-20

---

## Коротко

**Главное**

- Сильный промпт для агента - это не магическое заклинание, а структурированный брифинг: роль, задача, контекст, цифры, ограничения, формат ответа и критерий «сделано».
- Канон промпта из 7 деталей + готовый шаблон, который можно скопировать и подставить свою задачу. Работает и в ChatGPT, и в Claude Code.
- Три спасательных промпта, когда агент застрял: «прожарь свой ответ, ты уверен?», «я застрял - объясни и почини по шагам», «назови три гипотезы, почему не работает».
- Главный сдвиг 2026 года: от промпт-инжиниринга к контекст-инжинирингу. Важно не как ты спросил, а что агент видит перед глазами.
- Кому это: предпринимателю, руководителю, маркетологу, который работает с ИИ-агентом и устал получать «кашу» вместо результата.

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

**Главное**

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

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

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

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

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

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

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

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

**Главное**

Сильный промпт собирается из деталей, как изделие на сборочной линии: роль, задача, контекст, метрики, ограничения, формат ответа. Для агента добавляется седьмая деталь - критерий «сделано».

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

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

| Деталь | Что кладёшь | Пример |
|---|---|---|
| **Роль** | Кем должен быть агент, в какой области он эксперт | «Ты senior-разработчик на Next.js» |
| **Задача** | Глагол действия + конечная цель | «Собери форму подписки и подключи её к базе» |
| **Контекст** | Из какой области задача, детали бизнеса, что уже есть | «Проект на Prisma + Postgres, форма живёт на лендинге» |
| **Метрики / цифры** | Измеримые параметры: бюджет, сроки, размеры, лимиты | «Не больше 3 полей, грузиться меньше секунды» |
| **Ограничения** | Что делать НЕ нужно или прямо запрещено | «Не тащи новые библиотеки, только то, что уже в проекте» |
| **Формат ответа** | Как выдать результат: текст, буллеты, таблица, код, план | «Сначала план по шагам, код не пиши, пока не утвержу» |
| **Критерий «сделано»** | По какому признаку понятно, что задача закрыта | «Готово, когда форма отправляет тест-заявку в базу» |

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

**Правило одной детали**

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

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

> Чем точнее твои инструкции, тем меньше правок тебе потребуется.
>
> Anthropic, [Best practices for Claude Code](https://code.claude.com/docs/en/best-practices)

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

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

**Главное**

Шаблон ниже собирает все семь деталей в один запрос. Скопируй, подставь свою задачу - и сравни результат с тем, что даёт запрос в одну строку.

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

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

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

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

| Запрос в одну строку | Запрос по канону |
|---|---|
| «Сделай лендинг» | «Роль: веб-дизайнер. Задача: собрать одностраничный лендинг под запись на консультацию. Контекст: эксперт по недвижимости, аудитория - инвесторы 35+. Цифры: один экран, одна кнопка, грузится меньше 2 секунд. Ограничения: без стоковых картинок и лишних библиотек. Формат: сначала структура блоков на утверждение, потом код. Готово, когда кнопка ведёт на форму заявки» |
| «Почини баг» | «У меня ошибка при отправке формы. Контекст: [вставляю текст ошибки]. Что делал: нажал "отправить". Что ждал: заявка ушла. Что получил: белый экран. Найди корневую причину, не глуши симптом. Готово, когда форма отправляет тест-заявку» |

Левая колонка запускает лотерею. Правая - управляемый результат. При этом ты не написал ни строчки кода: ты выступил заказчиком, который умеет ставить задачу. Это ровно тот навык, о котором я говорю в гайде про [12 принципов вайбкодинга](/guides/vibecoding-dlya-predprinimatelya-12-principov) - ты архитектор, а не исполнитель.

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

**Главное**

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

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

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

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

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

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

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

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

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

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

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

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

**Маленький приём, который экономит нервы**

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

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

**Главное**

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

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

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

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

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

**Почему это не отменяет канон**

Контекст-инжиниринг не отменяет структуру запроса - он её разгружает. Постоянное (кто ты, стек, правила) уезжает в файлы, разовое (конкретная задача, критерий) остаётся в промпте. Одно без другого не работает: без канона агент не поймёт задачу, без контекста - будет решать её вслепую.

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

**Главное**

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

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

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

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

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

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

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

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

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

**Тот же приём - на крупных решениях**

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

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

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

**Главное**

Короткие ответы на четыре главных вопроса новичка: нужен ли идеальный промпт, чем агент отличается от чата, что делать с выдумками и с чего начать завтра.

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

**Нужно ли заучивать идеальные формулировки промптов?**

Нет. Заучивать волшебные слова не надо - модели давно понимают обычный язык. Надо держать в голове семь деталей канона и подкладывать агенту контекст файлами. Формулировка вторична, структура и контекст - первичны.

**Промпт для Claude Code отличается от промпта для ChatGPT?**

Основа одна - тот же канон. Разница в двух деталях: агенту важнее давать критерий «сделано» (он действует, а не просто отвечает) и явно просить «сначала план, код после утверждения». И агент читает контекст из файлов проекта, поэтому сам промпт короче.

**Что делать, если агент уверенно выдумывает?**

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

**С чего начать буквально завтра?**

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

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

**Главное**

Сильный промпт - это структурированный брифинг, а не удача. Освой канон из семи деталей, подложи контекст файлами и держи под рукой три спасательных промпта - и агент перестанет выдавать кашу.

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

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

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

Если хочешь не просто прочитать про это, а собрать систему работы с ИИ под свою команду - я провожу [интенсив по нейросетям для бизнеса](https://danashkin.ru/workshop): без магии, по делу, с результатом, который остаётся у вас.

### Источники

- [Anthropic - Best practices for Claude Code (как формулировать задачи, verification, plan-then-code)](https://code.claude.com/docs/en/best-practices)
- [Anthropic - Effective context engineering for AI agents, сентябрь 2025](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents)
- [Anthropic - Prompt engineering overview (структура и техники промптинга)](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/overview)
- [Anthropic - Claude Code Overview (что такое агентный инструмент разработки)](https://code.claude.com/docs/en/overview)