# Vibe Coding: Реальность и Реализация
Vibe coding — это одновременно и мем, и реальность 2025-2026 года. Кто-то называет это будущим разработки. Другие считают, что это способ генерировать технический долг со скоростью света.
Было решено попробовать создать коммерческий проект с нуля полностью с помощью вайбкодинга. В результате: 46 000 строк кода, полтора месяца, два человека. Проект работает, клиент пользуется.
Вообще как бы нифига себе – написать рабочую CRM, которая автоматизирует обработку входящих запросов и может автоматически работать по сделкам: отвечать на письма, ставить задачи, проводить сделку по воронке.
Создание этого проекта велось в два лица – один из созвонов, записанных ReadAi, собирал задачи, немного редактировал и из Claude Code Cli, используя MCP, декомпозировал таски в Jira. Коротко такой менеджер и аналитик в одном лице. И разработчик, который управлял всем оркестром, разбирал таски, реализовывал и тестировал.
Стек:
NestJS, NextJS, ShadCN UI, PostgreSQL
Эта статья не про то, как круто всё получилось. Она про то, как организовать работу с Claude Code (и аналогами), чтобы получить рабочий результат, а не кашу.
Часть 1: Настройка рабочего места
Структура проекта для AI
Главная ошибка – думать, что AI сам разберётся в проекте. Не разберётся. Точнее, разберётся, но потратит на это токены и контекст.
Claude.md – главный файл
Это точка входа. Здесь храним минимум информации и максимум ссылок. Не пишите сюда всё подряд. Напишите:
- Что это за проект (2-3 предложения)
- Какой стек
- Ссылки на файлы документации по модулям
- Базовые правила (что обновлять, куда смотреть)
Почему это важно:
claude.mdчитается при каждом запросе. Всё, что там написано – это токены, которые тратятся всегда. Чем меньше там мусора, тем больше места для реальной работы.- Документация по модулям
- Каждая крупная сущность – отдельный md-файл. В данном случае, например:
docs/deals.md— как работают сделкиdocs/email-processing.md— логика обработки почтыdocs/api.md— структура API- AI читает только то, что нужно для текущей задачи. Если работают с корзиной, ему не нужно знать про систему уведомлений.
- Агенты
- Это md-файлы с инструкциями для конкретных областей. Например:
agents/backend.md:- Какую архитектуру используем
- Какие паттерны обязательны
- Типичные ошибки, которых избегать
- Best practices для этого проекта
agents/database.md:- Какая ORM
- Правила работы с миграциями
- Оптимизация запросов (N+1, индексы)
- AI сам поймёт, к какому агенту обращаться, если в
claude.mdэто прописано.
Часть 2: Работа с контекстом
Один контекст = одна задача
Это главное правило. Не пытайтесь в одном контексте сделать весь модуль. Сделали задачу – clear. Нужно вернуться – resume.
Почему:
- когда контекст переполняется, Claude делает compact – сжимает историю. После этого он помнит примерно что было, но теряет детали. Если в этот момент он был на середине задачи, результат будет непредсказуемым.
- Plan mode для больших задач
- Если задача явно не влезает в один контекст (инициализация проекта, большой модуль), включайте plan mode. AI декомпозирует задачу на подзадачи, каждая будет решаться в своём контексте.
- Сколько это в цифрах
- На базовой подписке ($20) хватает на 3-5 часов активной работы. Потом лимиты сбрасываются. Планировали работу окнами. С хорошей документацией и правильной работой с контекстом этого достаточно для большинства задач.
Часть 3: Типичные проблемы и решения
AI не понимает вашу библиотеку
Симптом:- пишет код с ошибками, использует несуществующие методы
- создайте md-файл с документацией этой библиотеки. Можно попросить AI сгенерировать – дать ссылку на официальную документацию и попросить структурировать.
AI забывает контекст
Симптом:- начинает переспрашивать то, что уже обсуждали
- вышли за рамки контекста. Делайте Clear и начинайте с чёткой постановки задачи. Если задача большая, разбивайте на части.
AI пишет дублирующийся код
Симптом:- создаёт новые компоненты вместо переиспользования существующих
- в запросе указывайте, что нужно переиспользовать существующие компоненты.
AI не может найти нужные файлы
Симптом:- тратит значительную часть контекста на поиск нужных файлов
- используйте плагины, такие как Serena, для навигации по проекту.
Часть 4: Работа с интеграциями
При работе с интеграциями:
- Сначала документация в md-файл
- Потом работа с API
Итого: чеклист для старта
Перед началом проекта:
- Создать
claude.mdс базовой информацией - Определить структуру документации по модулям
- Создать агентов для основных областей (backend, frontend, database)
- Установить нужные плагины
В процессе работы:
- Одна задача = один контекст
- Clear после завершения задачи
- Обновлять документацию при изменениях
- Ревьюить результат