Хороший промпт для старта проекта не описывает продукт. Он заставляет агента сначала пересказать задачу, задать вопросы и показать план, и только потом писать код. Один такой промпт экономит час объяснений и десяток переделок. Ниже разберем, из чего он состоит, дадим готовый шаблон для копирования и покажем, как запустить его в Cursor, Claude Code и Windsurf.
TL;DR. Промпт перед кодингом переключает агента из режима «сделай красиво» в режим архитектора: роль, контекст, ограничения, критерий готовности плюс приказ задать вопросы и выдать план с рисками. Работает в Cursor, Claude Code и Windsurf. В статье: разбор блоков, готовый шаблон и три фразы, которые заставляют модель думать глубже.
Почему «сделай красиво» ломает проект еще до старта?
Расплывчатая задача заставляет агента додумывать. Он выбирает первый попавшийся путь, трогает лишние файлы и уводит проект не туда, а вы это видите только в готовом коде.
Агент быстрый. Иногда слишком. Вы просите «быстро накидать сайт», и через минуту он переписал структуру, добавил библиотеку, которую вы не хотели, и завязал логику на неверное предположение. Разбор в официальной документации Claude Code описывает ровно этот сценарий: без плана модель меняет 12 файлов, а ваш единственный откат — стереть всё и начать заново (docs.anthropic.com).
Корень не в модели, а в том, как ее просят. По разбору популярного гайда с YouTube, вместо двух слов нужен развернутый запрос: роль, задача, формат, контекст. Двухсловная просьба оставляет агенту слишком много свободы. А свобода без брифа превращается в угадайку, где проигрываете вы.
Что должен сделать агент до первой строчки кода?
Четыре вещи: пересказать задачу, задать вопросы, показать план по файлам и выписать риски с допущениями. Это и есть разница между разовой удачей и предсказуемым результатом.
Внутри режима планирования Claude Code задача разбита на строгие фазы: понять, спроектировать, задать уточняющие вопросы, оформить финальный план, отдать на утверждение. Ключевая фаза — вопросы. Именно там всплывает то, что вы забыли сказать, а агент собирался домыслить. Это подтверждают и разборы внутренней механики инструмента, и опыт команды Anthropic.
Логика простая. Агент работает по циклу «прочитай, подумай, действуй, проверь, скорректируй». Если убрать первые два шага и прыгнуть сразу к «действуй», вы получаете кое-как работающий скрипт и долгую отладку. План стоит 30 секунд чтения. Отладка неверного кода — часы. Разработчики, которые выжимают из AI максимум, тратят до 80% времени на планирование и лишь 20% на контроль исполнения. Не потому, что код медленный. Потому что дорого стоит неправильный.
Как выглядит промпт для старта проекта целиком?
Готовый шаблон ниже: роль и запрет на код, контекст с ограничениями, приказ пересказать и спросить, требование плана и рисков, самооценка и пауза перед кодом. Копируйте и заполняйте под себя.
Стартовый промпт для планирования проекта собирается из шести блоков. Каждый снимает конкретный риск: роль задает уровень мышления, контекст убирает угадайку, запрет на код держит агента в режиме архитектора. Вот шаблон, который мы в VibeCoderz кидаем агенту на каждом новом проекте.
Ты senior-разработчик и продуктовый архитектор с 10 годами опыта.
Мы начинаем новый проект. Пока НЕ пиши код.
Контекст:
- Что делаем: [продукт в одном-двух предложениях]
- Для кого: [пользователь и его задача]
- Стек и ограничения: [язык, фреймворк, бюджет, дедлайн, что трогать нельзя]
- Готово, когда: [1-3 критерия]
Сначала сделай четыре вещи:
1. Перескажи задачу своими словами, как ты ее понял.
2. Задай мне уточняющие вопросы по всему неясному. Ничего не додумывай.
3. Покажи план: какие файлы создашь, в каком порядке, какие
архитектурные решения принимаешь и почему.
4. Отдельным блоком выпиши: какие допущения ты делаешь, что может
пойти не так, где самые большие риски.
В конце оцени план по 10-балльной шкале и предложи, что улучшить.
Жди моего «поехали», прежде чем писать код.Почему в промпте так важен блок ограничений?
Последние строки про стек и запреты часто решают судьбу всего результата. Без них агент подтягивает случайные библиотеки и паттерны, которые вам потом выпиливать.
По одному из разборов, 500 слов внятного брифа превращали сломанный проект на 500 МБ в рабочие 30 КБ кода, и разницу делали именно последние пять пунктов про стек. Пишите прямо: «не ставь новых npm-пакетов», «используй то, что уже в проекте», «не трогай папку auth». Точное требование весит больше красивой абстракции. Императивный стиль, где вы описываете пошаговый алгоритм, работает лучше, чем «сделай хорошо».
Как запустить этот промпт в Cursor, Claude Code и Windsurf?
В Claude Code есть встроенный режим планирования по Shift+Tab дважды. В Cursor и Windsurf тот же результат дает фраза в промпте: сначала план, код только после моего «ок».
В Claude Code это отдельный read-only режим. Нажимаете Shift+Tab дважды или пишете /plan, и агент физически не может редактировать файлы, пока вы не одобрите план. Ограничение вшито на уровне инструмента, а не держится на честном слове модели. Создатель Claude Code Борис Черный оценивает связку «план плюс проверка своей работы» в прирост качества в 2-3 раза.
В Cursor и Windsurf отдельной кнопки нет, но механика воспроизводится текстом. Достаточно начать промпт с запрета на код и требования плана. Модель распознает «сначала покажи, что будешь делать» как сигнал не трогать файлы до одобрения. Разница между инструментами — в удобстве, а не в возможности.
| Инструмент | Как включить режим плана | Что удобно |
|---|---|---|
| Claude Code | Shift+Tab дважды или /plan | Жесткий read-only, план сохраняется в файл |
| Cursor | Фраза в промпте: план до кода | Правки плана прямо в редакторе |
| Windsurf | Фраза в промпте: план до кода | Экономия токенов на старте |
Полный каталог инструментов с ценами и разбором лежит в каталоге AI-инструментов.
Какие вопросы заставляют агента думать лучше?
Три фразы работают как переключатель глубины: «какие допущения ты делаешь», «что может пойти не так», «оцени свой план». Они вскрывают скрытые предположения и краевые случаи до кода.
Это не магия, а способ дать модели дополнительный бюджет на рассуждение. Вопрос про допущения вытаскивает наружу то, что агент молча решил за вас. Вопрос про риски гонит его искать краевые случаи. Просьба оценить план по шкале запускает самокритику, и он сам находит слабые места. Проверено на десятках сессий: три коротких вопроса дают более честный план, чем абзац уточнений.
Добавьте сюда правило самопроверки. Попросите агента после плана прогнать его через петлю обратной связи: «проверь, не противоречит ли план ограничениям выше». Без такой петли на выходе часто кривой скрипт, который вроде работает, а по факту разваливается на первом же нестандартном вводе.
| Фраза в промпте | Что вскрывает |
|---|---|
| Какие допущения ты делаешь? | Молчаливые решения, которые агент принял за вас |
| Что может пойти не так? | Краевые случаи и риски до написания кода |
| Оцени план и предложи улучшения | Слабые места, которые модель находит сама |
Максим: «VibeCoderz мы собрали за неделю тремя скриптами. Я надиктовал голосом в Claude Code, что хочу, он сам разложил на шаги и пошел. 6 200 материалов на портале уже. Ребят, это работает: чем точнее объяснишь на старте, тем меньше переделываешь потом.»
Когда промпт-планирование только мешает?
Когда правку можно описать одним предложением. Поправить текст ошибки, поменять цвет кнопки, исправить опечатку. На таких задачах плановый промпт крадет время, а не экономит.
Официальная рекомендация Anthropic прямая: если можете описать изменение одной фразой, план пропускайте. Одна-две правки в известном файле не требуют брифа, вопросов и рисков. Здесь плановый промпт добавляет трение на ровном месте, а обычный режим справится быстрее.
Есть и вторая честная оговорка. Режим планирования тратит токены на исследование кода. На большом проекте и слабом тарифе это чувствуется. Поэтому правило такое: план включаем, когда задача трогает много файлов, меняет архитектуру или вы работаете в незнакомой кодовой базе. На всё остальное — обычный режим.
Итог: с чего начинать каждый новый проект
Стартовый промпт с брифом, вопросами и планом стал стандартом для серьезной работы с агентами в 2026. Он превращает «сделай красиво» в предсказуемый результат за счет 30 секунд чтения плана.
Правило на каждый день простое. Сложный или незнакомый проект — начинаете с планового промпта, читаете план, правите, запускаете. Мелкая понятная правка — пишете напрямую. Один раз собранный стартовый шаблон дальше работает годами: сохраните его в файл и подкладывайте в каждый новый проект, меняя только контекст.
| Тип задачи | Режим | Почему |
|---|---|---|
| Новый проект, много файлов | Промпт с планом | Ловите непонимание до кода |
| Незнакомая кодовая база | Промпт с планом | Агент сначала изучает, потом действует |
| Правка в одно предложение | Обычный режим | План только замедлит |
| Опечатка, цвет, текст | Обычный режим | Риск отката минимальный |
FAQ
Зачем писать промпт перед началом проекта, если можно просто дать задачу? Стартовый промпт заставляет агента пересказать задачу, задать вопросы и показать план до кода. Так вы ловите непонимание за пару минут, а не после того, как он перелопатил десяток файлов не туда.
Работает ли такой промпт в Cursor и Windsurf или только в Claude Code? Работает везде. В Claude Code есть отдельный режим по Shift+Tab дважды. В Cursor и Windsurf тот же эффект дает фраза в промпте: сначала план, код только после моего одобрения.
Что обязательно класть в промпт перед стартом? Роль агента, контекст продукта, стек и ограничения, критерий готовности. Плюс инструкцию: пересказать задачу, задать вопросы, показать план и выписать риски с допущениями.
Какие фразы заставляют агента думать тщательнее? Три рабочие: какие допущения ты делаешь, что может пойти не так, оцени свой план и предложи улучшения. Они вскрывают скрытые предположения и краевые случаи до кода.
Когда стартовый промпт с планом лишний? Когда правку можно описать одним предложением: поправить текст ошибки, поменять цвет кнопки, исправить опечатку. На таком плановый промпт только замедляет.
Сколько раз править промпт, пока он не заработает? Обычно 3-5 итераций на новый тип задачи. Через неделю практики нормальный результат приходит со второго запроса. Промпт стоит сохранять в файл и переиспользовать, как кусок кода.
Можно ли надиктовать бриф голосом вместо того, чтобы печатать? Да, и часто это даже лучше. Голосом вы отдаете больше контекста и нюансов, чем в сухом тексте. Ошибки и оговорки агент понимает, а деталей ловит больше.
Глоссарий
Вайбкодинг — создание цифровых продуктов через описание задачи словами, а не через ручное написание кода. Вы направляете AI, он пишет.
AI-агент — режим нейросети, где исполнителем выступает машина, а человек руководит процессом по циклу «прочитай, подумай, действуй, проверь, скорректируй».
Режим планирования (Plan Mode) — состояние Claude Code, в котором агент изучает код и предлагает план, но не может редактировать файлы до вашего одобрения.
Бриф — стартовое описание задачи для агента: продукт, пользователь, стек, ограничения и критерий готовности.
Допущения — молчаливые решения, которые агент принимает за вас, если вы не спросили о них напрямую.
Критерий готовности — понятное условие, по которому вы и агент одинаково понимаете, что задача выполнена.
Петля обратной связи — правило самопроверки, при котором агент сверяет результат с исходными ограничениями перед тем, как отдать код.
Собираете первый проект и хотите пройти путь от идеи до рабочей ссылки без граблей? Загляните в каталог AI-инструментов VibeCoderz с разбором Cursor, Claude Code и Windsurf. А если нужен разбор под вашу задачу, запишитесь на консультацию к Максиму — покажет, как выстроить старт под конкретный продукт.
Материал обновлен в марте 2026. Данные по режимам инструментов актуальны на июль 2026, проверяйте цены и версии на официальных сайтах.