🎯 О чём этот конспект: Разбор практических ошибок при использовании AI-агентов (Cursor, Claude Code), методология «Инженерии контекста» и обзор инструмента Superpowers для управления сложными проектами. Автор делится опытом настройки автономной команды нейро-сотрудников и правильного планирования перед написанием кода.

👤 Кому будет полезно: Вайбкодерам, разработчикам и предпринимателям, которые хотят создавать IT-продукты с помощью AI, минимизируя галлюцинации и «мусорный» код.

✨ Что получите: Пошаговый алгоритм подготовки PRD (документа требований) через AI, методику работы с субагентами в Claude Code и готовые промпты для настройки «режима планирования».

1. Главная ошибка вайбкодинга: Отсутствие планирования

Контекст: Большинство новичков начинают с промпта «сделай мне приложение». Это приводит к тому, что AI генерирует 100 строк плохого кода из-за одной неверной строчки в логике. Искусственный интеллект — это мультипликатор: если на входе «мусор» (нечеткая задача), на выходе будет «мусор» в квадрате. Важно разделять фазу обдумывания архитектуры и фазу написания кода.

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

Как применить:

• Шаг 1: Создание точки истины — Создайте в корне проекта файл plan.md или PRD.md.
• Шаг 2: Режим планирования — В Claude Code используйте сочетание Shift + Tab для перехода в Planning Mode. В этом режиме агент не пишет код, а только обсуждает архитектуру.
• Шаг 3: Формирование требований — Используйте промпт для составления плана:

Проанализируй текущий проект и составь подробный план реализации фичи [Название фичи]. 
Разбей задачу на микро-шаги по 2-5 минут каждый. 
Не начинай писать код, пока я не утвержу архитектурный подход. 
Результат запиши в файл plan.md.

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

2. Инженерия контекста: Управление «памятью» агента

Контекст: Когда контекстное окно заполняется более чем на 40%, качество работы модели резко падает. Лишние файлы, огромные логи и ненужные MCP-инструменты «съедают» полезный объем памяти (токены). Нужно осознанно очищать сессии и подавать агенту только релевантную информацию.

Выгода: Высокая точность ответов модели и корректное следование сложным инструкциям.

Как применить:

• Шаг 1: Очистка сессии — Регулярно начинайте новый чат, сохраняя прогресс в файле memory.md или CLAUDE.md.
• Шаг 2: Системные правила — Настройте файл .claudecode/config.json или системный промпт, чтобы ограничить агента.
• Шаг 3: Проверка контекста — В Claude Code используйте команду для визуализации занятого объема:

/context

Результат: Агент всегда «помнит» главное и не отвлекается на неактуальные части кода.

3. Использование Superpowers для Claude Code

Контекст: Superpowers — это надстройка (набор скиллов) для Claude Code, которая заставляет AI работать как профессиональный тимлид. Она включает в себя стадии брейншторминга, дебаггинга и ревью. Агент начинает интервьюировать вас, задавая уточняющие вопросы, прежде чем трогать файлы.

Выгода: Профессиональная архитектура проекта даже у тех, кто не умеет программировать.

Как применить:

• Шаг 1: Установка — Склонируйте репозиторий со скиллами в папку проекта.
• Шаг 2: Запуск брейншторма — Вызовите специальную команду для проектирования:

/brainstorm "Я хочу добавить систему модерации комментариев в мой стрим-сервис"

• Шаг 3: Фиксация дизайна — Агент предложит 2-3 варианта реализации. Выберите один, и он автоматически обновит plan.md.

Результат: AI не пишет код «на бум», а следует утвержденному вами дизайну системы.

4. Оркестрация субагентов: Создание нейро-команды

Контекст: Для разных задач (Frontend, Backend, DevOps) лучше использовать специализированных субагентов с разными системными промптами. Например, фронтенд-агент должен знать ваш стек (Tailwind, Next.js) и правила дизайна (Shadcn UI), чтобы не плодить «фиолетовую халтуру».

Выгода: Код соответствует вашим стандартам качества и стилистике.

Как применить:

• Шаг 1: Описание агента — Создайте файл frontend_agent.md с описанием роли.
• Шаг 2: Привязка к триггерам — Пропишите в системном промпте правило:

Если задача касается UI или компонентов React, делегируй выполнение субагенту 'Frontend Developer', используя инструкции из файла frontend_agent.md. Всегда используй Tailwind и компоненты из библиотеки Shadcn.

• Шаг 3: Вызов агента — В процессе работы Claude Code сам предложит переключиться на специализированную модель.

Результат: Вы управляете не одним чатом, а целым «отделом разработки».

FAQ

В: Какую модель лучше выбрать для вайбкодинга в конце 2024 — начале 2025?

О: Сейчас лидирует Claude 3.7 Sonnet и Claude 3.5 Opus. Также стоит обратить внимание на GPT-4.5 (или GPT-5.1 Codex Max), которые временно доступны бесплатно в Cursor. Для глубокого ресерча лучше всего подходит Perplexity в режиме Deep Research.

В: Как получить доступ к топовым моделям бесплатно?

О: Используйте Anti-Gravity (IDE от Google), там часто доступны мощные модели бесплатно в рамках триалов. Также следите за акциями в Cursor (бесплатные периоды для новых моделей).

В: Что делать, если AI постоянно пишет код с ошибками?

О: Перейдите в режим планирования (Shift+Tab). Попросите AI сначала провести «Code Review» текущего состояния и составить список несоответствий. Не давайте ему писать код, пока он сам не объяснит причину ошибки словами.

В: Зачем нужны MCP (Model Context Protocol), если они едят контекст?

О: MCP нужны для связи AI с внешним миром: браузером, базой данных или Google Maps. Если вы новичок — забудьте про них на первые 2 недели. Сначала научитесь планировать и промптить.

В: Как использовать NotebookLM для разработки?

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

Конспект создан на основе видео «Как НЕ надо вайб-кодить. Разбор ошибок и новости» канала Сережа Рис. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=Q5q5dwrSulA