🎯 О чём этот конспект: Пошаговое руководство по использованию Windsurf — инновационной IDE от Codium, которая использует агентный подход (Cascade) для написания кода. В видео разбирается создание трёх реальных проектов: анализатора инвойсов, сервиса реперпозинга контента со Stripe-интеграцией и мессенджера с ИИ-переводом в реальном времени.
👤 Кому будет полезно: Вайбкодерам, разработчикам на Next.js, владельцам AI-агентств и всем, кто хочет создавать сложные IT-продукты с минимальным написанием кода вручную.
✨ Что получите: Вы научитесь настраивать среду Windsurf, правильно структурировать промпты через файл instructions.md, интегрировать Supabase, Stripe и Azure AI, а также деплоить готовые приложения на Railway.
1. Windsurf и агент Cascade: Новая эра в разработке
Контекст: Windsurf — это не просто автодополнение кода, а первая агентная IDE. В отличие от расширений для VS Code, здесь встроен агент Cascade, который обладает глубоким пониманием всей кодовой базы и может самостоятельно выполнять команды в терминале, читать файлы и исправлять ошибки. Это позволяет работать в режиме «парного программирования», где ИИ берет на себя рутину и архитектурные решения.
Выгода: Сокращение времени разработки MVP с недель до нескольких часов за счет автоматизации настройки окружения и исправления багов.
Как применить:
- Шаг 1: Установка — Скачайте Windsurf с официального сайта Codium. Так как он построен на базе VS Code, вы можете импортировать все свои расширения и настройки.
- Шаг 2: Использование Cascade — Используйте
Cmd+L(илиCtrl+L), чтобы вызвать чат с агентом. Cascade видит не только открытый файл, но и всю структуру проекта. - Шаг 3: Терминальные команды — Позволяйте агенту самому запускать
npm installилиnpm run dev. Вам нужно только нажать "Accept" в окне чата.
2. Золотой стандарт промптинга: Файл instructions.md
Контекст: Для качественной генерации сложного приложения нельзя просто кидать короткие промпты в чат. Автор использует методику «Instruction-Driven Development». Создается детальный Markdown-файл, который служит «библией» проекта. В нем описываются стек, структура БД, логика каждой фичи и даже куски документации внешних API.
Выгода: Минимизация галлюцинаций ИИ и сохранение контекста даже при длительной разработке.
Как применить:
- Шаг 1: Создание файла — В корне проекта создайте
instructions.md. - Шаг 2: Структурирование — Разделите файл на секции: Overview, Tech Stack, Core Features (пошагово), Database Schema и Documentation Snippets.
- Шаг 3: Добавление документации — Скопируйте примеры кода из официальной документации (например, Azure SDK или Stripe API) прямо в этот файл.
- Шаг 4: Ссылка в промпте — При каждом новом запросе в Cascade добавляйте:
Read and strictly follow the instructions in @instructions.md. We are now building Feature #2: [Название фичи].3. Проект 1: Анализатор инвойсов с Azure Document Intelligence
Контекст: Приложение позволяет загружать PDF-инвойсы, выбирать поля для извлечения (имя клиента, сумма, дата) и скачивать результат в JSON/CSV. Основная сложность здесь — интеграция с тяжеловесными enterprise-сервисами вроде Azure.
Выгода: Готовый инструмент для автоматизации бухгалтерии, созданный за 1-2 часа.
Как применить:
- Шаг 1: Настройка Azure — Создайте ресурс "Document Intelligence" в портале Azure, получите API Key и Endpoint.
- Шаг 2: Инициализация проекта — Попросите Cascade создать Next.js проект и установить зависимости:
npx create-next-app@latest doc-analyzer --typescript --tailwind --eslint
npm install @azure/ai-form-recognizer- Шаг 3: Реализация фичи — Используйте промпт для связки UI и Azure:
Implement the data extraction feature using Azure Document Intelligence.
Refer to the schema in @instructions.md for predefined fields.
Handle the PDF upload with a preview and show the extracted data in a sidebar.- Шаг 4: Исправление UI по скриншоту — Сделайте скриншот желаемого интерфейса и загрузите его в Windsurf с промптом: "Update the UI to look like this image, but don't break the functionality".
4. Проект 2: Content Repurposing SaaS (Supabase + Stripe)
Контекст: Сложное приложение с авторизацией, базой данных и системой токенов (оплата за генерации). ИИ перерабатывает YouTube-видео или статьи в посты для LinkedIn и X.
Выгода: Понимание того, как строить полноценные SaaS-платформы с монетизацией.
Как применить:
- Шаг 1: База данных Supabase — Попросите Cascade сгенерировать SQL-миграцию для таблиц
profiles,personas,contentиtokens. Выполните её в SQL Editor на сайте Supabase. - Шаг 2: Система токенов — Настройте логику: при каждой генерации через Claude API (Anthropic) вычитайте токены из таблицы пользователя.
- Шаг 3: Stripe Integration — Создайте продукты в Stripe (одноразовые платежи). Добавьте Webhook для обработки успешной оплаты:
# Для локального тестирования Stripe Webhooks
stripe listen --forward-to localhost:3000/api/webhooks- Шаг 4: Деплой на Railway — Подключите GitHub репозиторий к Railway.app, добавьте все Environment Variables из
.env.localв настройки Railway.
5. 10 Best Practices для работы с AI-кодером
Контекст: Опыт 60+ часов работы с Windsurf позволил автору выделить критические правила, которые предотвращают «поломку» проекта.
Выгода: Стабильный код и отсутствие багов при масштабировании приложения.
Как применить:
- Clear Instructions: Всегда имейте актуальный
instructions.md. - Feature Splitting: Стройте одну фичу за раз, тестируйте её и только потом идите дальше.
- Docs Snippets: Вставляйте куски документации в контекст ИИ.
- New Chats: Начинайте новый чат для каждой новой фичи, чтобы очистить контекст от старых ошибок.
- App Running: Держите
npm run devвключенным, чтобы сразу видеть изменения. - Image Debugging: Используйте скриншоты ошибок или UI для правок.
- Partial Acceptance: Не принимайте весь код сразу, если ИИ затронул лишние файлы.
- Safety Prompt: Добавляйте фразу "Do not mess up existing functionality" в каждый запрос.
- Git Checkpoints: Делайте
git commitпосле каждой рабочей фичи. Это ваш "Save Point". - O1 Model for Logic: Если Cascade зациклился на ошибке, скопируйте код в ChatGPT (модель o1) для глубокого анализа логики.
Windsurf AI: ответы на частые вопросы
В: Чем Windsurf лучше Cursor? О: Windsurf использует агент Cascade, который лучше справляется с терминалом и пониманием структуры проекта «из коробки». Также он более автономен в исправлении цепочек ошибок без участия пользователя.
В: Как избежать огромных счетов в Azure или Anthropic при разработке? О: Используйте бесплатные лимиты (Azure дает $200 новым юзерам). В коде всегда ограничивайте максимальное количество токенов для генерации и тестируйте логику на небольших кусках текста.
В: Что делать, если ИИ постоянно ломает старый рабочий код? О: Используйте Git. Перед каждым крупным запросом делайте коммит. Если ИИ сломал базу, просто откатитесь (Rollback). Также четко указывайте в промпте: "Only modify [specific file], do not touch others".
В: Как деплоить приложения с базой данных? О: Автор рекомендует Railway.app. Это проще, чем AWS. База данных (Supabase) остается внешней, вам нужно только прописать URL подключения в переменных окружения на Railway.
В: Можно ли создавать мобильные приложения в Windsurf? О: Да, через React Native или создавая адаптивные Web-приложения (PWA). В видео показан пример мессенджера, который полностью оптимизирован под мобильные экраны.
Конспект создан на основе видео «Windsurf AI Masterclass: The Best AI Coder?» канала Ahmed S. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=9eF51MGhOEk