Промпт-инжиниринг в контексте вайбкодинга — это умение формулировать задачи так, чтобы AI генерировал именно тот код, который вам нужен. Качество промпта напрямую определяет качество кода. Плохой промпт — рефакторинг на час. Хороший — рабочий код с первой попытки.
Принцип 1: Контекст решает всё
AI не знает о вашем проекте ничего, кроме того что вы ему рассказали. Начните с контекста: какой стек, какая архитектура, какие зависимости. CLAUDE.md и .cursorrules решают эту проблему автоматически, но в каждом промпте тоже помогает указать контекст: "В нашем Next.js приложении с Payload CMS добавь...".
Принцип 2: Одна задача — один промпт
Не пишите: "Создай авторизацию, добавь CRUD для товаров и сделай красивый дашборд". Вместо этого: "Создай JWT-авторизацию с refresh token через httpOnly cookie". Завершили — следующий промпт для CRUD. Маленькие итерации = меньше ошибок.
Принцип 3: Будьте конкретны
Плохо: "Сделай API для пользователей". Хорошо: "Создай REST API для пользователей: GET /api/users (список с пагинацией), GET /api/users/:id, POST /api/users (регистрация с валидацией email), PUT /api/users/:id (обновление профиля, только владелец)". Конкретика = предсказуемый результат.
Принцип 4: Укажите ограничения
AI любит overengineering. Без ограничений он может добавить кэширование Redis, очередь задач и микросервисную архитектуру для TODO-приложения. Говорите явно: "Без кэширования", "Простая реализация, без лишних абстракций", "Максимум 50 строк".
Принцип 5: Показывайте примеры
Если в проекте уже есть похожий код, сошлитесь на него: "Сделай API для товаров по аналогии с /api/users". AI прочитает существующий код и повторит паттерны. Это надёжнее, чем описывать архитектуру словами.
Принцип 6: Просите план перед кодом
Для сложных задач: "Сначала опиши план реализации, потом пиши код". AI покажет список шагов и файлов. Вы проверите подход ДО написания кода. Дешевле исправить план, чем переписывать 500 строк.
Принцип 7: Итерируйте быстро
Первая версия не идеальна — это нормально. Вместо переписывания промпта с нуля, добавляйте уточнения: "Теперь добавь обработку ошибок", "Вынеси валидацию в отдельную функцию", "Добавь тесты для edge cases". Каждая итерация улучшает код.
Антипаттерны промптов
Слишком общий промпт
"Сделай хороший код" — AI не знает что значит "хороший" в контексте вашего проекта. Укажите конкретные критерии: типизация, тесты, обработка ошибок, размер функций.
Слишком длинный промпт
Промпт на 3 экрана → AI потеряет фокус на деталях. Если задача большая — разбейте на 3-5 промптов. Каждый решает одну подзадачу.
Промпт без проверки
"Сделай и закоммить" — опасно. Всегда оставляйте шаг для ревью. Просите AI показать diff перед коммитом, запустить тесты, проверить типы.
Промпт-шаблоны для вайбкодинга
Для нового файла: "Создай [тип файла] в [путь]. [Что делает]. Используй [паттерн из проекта]. Добавь тесты." Для рефакторинга: "Отрефактори [файл]: [конкретно что улучшить]. Не меняй публичный API. Запусти тесты после." Для баг-фикса: "В [файл] баг: [описание]. Ожидаемое поведение: [что должно быть]. Найди причину и исправь."