Vibe Coding — рабочая инструкция
Vibe Coding · рабочая инструкция

Как эффективно работать с AI в коде

Эта страница — не статья, а рабочая панель промптов. Используй её, когда работаешь в VS Code, GitHub, Claude, Cursor или другой AI-среде. Главная задача — быстрее давать точные команды и не позволять AI ломать проект лишней инициативой.

Быстрый старт

Самые частые команды. Нажал — скопировал — вставил в Claude или другую модель.

Универсальная задача

Когда нужно начать работу с конкретной проблемой.

Ввести AI в контекст

Когда нужно оценить существующий проект перед работой.

Новый проект

Когда начинаешь с нуля и нужно утвердить структуру.

Диагностика ошибки

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

Рабочий протокол

Не проси AI сразу «сделать». Веди его по шагам. Иначе он начнёт менять то, что не просили.

Дай контекст Страница, функция, проблема, что уже известно.
Попроси диагностику Сначала найти файлы и причину. Код не менять.
Утверди план AI предлагает шаги, ты разрешаешь только нужное.
Требуй отчёт Файлы, изменения, проверка, риски, что не трогал.
Жёсткое правило: чем больше проект, тем меньше должна быть одна задача для AI.

Сценарии: что просить у AI

Быстрая таблица для выбора правильного режима работы.

Ситуация Что просить Режим Что важно запретить
Не понимаю, где ошибка Найти причину без изменений в коде Диагностика Не менять файлы до плана
Нужно исправить один баг Минимальный патч в связанных файлах Точечная правка Не делать рефакторинг
Нужно добавить функцию Сначала план, потом реализация Архитектура Не менять структуру без согласования
AI начал менять лишнее Ограничить область изменений Стоп-кран Не трогать соседний функционал
Проект стал большим Создать PROJECT_MAP.md Навигация Не менять код
Новый чат Передать краткий контекст проекта Контекст Не тащить весь старый чат
Есть токены или пароли Проверить хранение секретов Безопасность Не коммитить .env

Готовые промпты

Основные команды для ежедневной работы. Используй карточки: копируй сразу или раскрывай полный текст.

База

Универсальная задача

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

Диагностика

Найти причину ошибки

Когда нужно сначала разобраться, а не позволить AI сразу лезть в код.

Правка

Точечная правка

Для одного бага или небольшого изменения без рефакторинга и без затрагивания соседних блоков.

Архитектура

Крупное изменение

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

Выполнение

После утверждения плана

Когда AI уже предложил план, и ты разрешаешь выполнить только конкретные пункты.

Контроль

Отчёт после правки

Чтобы AI не писал просто «готово», а фиксировал результат, риски и способ проверки.

Дизайн

Правка визуала

Когда нужно улучшить интерфейс без фразы «сделай красиво» и без лишней самодеятельности.

Мобайл

Починить мобильную вёрстку

Когда карточки, таблицы или блоки ломаются на маленьких экранах — без затрагивания десктопа.

Новый чат

Передать контекст

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

Новый проект

Начать проект с нуля

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

Аудит

Ввести AI в контекст проекта

Когда нужно оценить существующий проект перед началом работы — чтобы AI понял структуру и не ломал лишнее.

Файлы, которые стоит создать в проекте

Эти файлы помогают AI быстрее понимать проект и меньше делать глупостей.

PROJECT_CONTEXT.md Описание проекта, цели, страницы, интеграции, ограничения.
PROJECT_MAP.md Карта папок, файлов, компонентов, API, стилей и критичных мест.
AI_RULES.md Правила работы AI: что можно, что нельзя, как сдавать результат.
CHANGELOG_AI.md Журнал изменений: дата, задача, файлы, проверка, риски.
.env.example Пример переменных окружения без реальных ключей и паролей.
SECURITY_NOTES.md Правила хранения токенов, API-ключей и приватных данных.
Создать PROJECT_MAP.md
Изучи структуру проекта и создай файл PROJECT_MAP.md.

Мне нужно, чтобы ты описал:
1. Основные папки проекта
2. За что отвечает каждая папка
3. Главные страницы и где они лежат
4. Где находится логика API
5. Где находятся стили
6. Где находятся компоненты
7. Где конфиги
8. Какие файлы критичные и требуют осторожности
9. Как запускать проект локально
10. Как проверять изменения

Ничего в коде не меняй.
Шаблон AI_RULES.md
# Правила работы AI с проектом

1. Перед изменениями сначала понять текущую логику.
2. Не делать рефакторинг без отдельного запроса.
3. Не менять архитектуру без согласования.
4. Не трогать .env, ключи, токены и приватные данные.
5. Работать минимальными изменениями.
6. После каждой задачи указывать:
   - какие файлы изменены
   - что именно изменено
   - как проверить
   - какие риски остались
7. Если задача неясна — сначала задать уточняющий вопрос или предложить план.
8. Не создавать новые зависимости без согласования.
9. Не удалять код без объяснения.
10. Не менять рабочую логику соседних страниц.
11. Если нужно изменить больше файлов, чем ожидалось, сначала остановиться и объяснить причину.
12. После крупных задач предлагать обновление CHANGELOG_AI.md.

Безопасность: пароли, токены, API-ключи

Важно: если пароль, токен или API-ключ попал в чат, код или GitHub — считай его скомпрометированным. Его нужно заменить.
Базовые правила безопасности
  • Реальные ключи хранятся только в .env.
  • .env должен быть добавлен в .gitignore.
  • В GitHub можно отправлять только .env.example.
  • Нельзя вставлять реальные токены в публичный код.
  • Если ключ уже попал в GitHub — его нужно перевыпустить.
  • После работы с секретами нужно проверить историю коммитов.
Проверка хранения чувствительных данных
Проверь, как в проекте организовано хранение чувствительной информации.

Под чувствительной информацией я имею в виду:
— API-ключи
— токены
— логины
— пароли
— секреты вебхуков
— доступы к внешним сервисам

Ничего не меняй сразу.

Сначала дай отчёт:
1. Есть ли реальные секреты в коде
2. Есть ли файл .env
3. Добавлен ли .env в .gitignore
4. Есть ли .env.example
5. Какие файлы требуют внимания
6. Есть ли риск, что секреты попали в GitHub
7. Что нужно сделать для безопасного хранения

Код пока не меняй.

Плохие и хорошие формулировки

AI хорошо работает с конкретикой. Размытые задачи почти всегда приводят к лишним правкам.

Не писать

  • Сделай красиво.
  • Исправь всё.
  • Наведи порядок.
  • Оптимизируй проект.
  • Посмотри, что не так.
  • Доделай сайт.

Писать вместо этого

  • Исправь мобильное отображение карточки на странице /casino.
  • Не трогай десктопную версию.
  • Сначала найди файлы, отвечающие за этот блок.
  • Предложи план, код пока не меняй.
  • Работай минимальным патчем.
  • После правки дай отчёт и способ проверки.

Чек-лист перед отправкой задачи AI

1. Одна задача
Не смешивать баг, дизайн, архитектуру и интеграции в один запрос.
2. Есть контекст
Указать страницу, файл, функцию или конкретную проблему.
3. Есть ограничения
Написать, что нельзя трогать.
4. Сначала план
Для сложных задач не разрешать сразу писать код.
5. Есть проверка
Указать, как понять, что задача выполнена правильно.
6. Нужен отчёт
Файлы, изменения, риски, способ проверки.

Главная мысль

Vibe coding работает хорошо, когда AI не получает власть над проектом, а получает точную задачу, понятные границы и обязанность отчитаться.

AI может ускорить разработку в несколько раз. Но если не управлять им жёстко, он с такой же скоростью внесёт хаос в проект.

Скопировано
Made on
Tilda