🎯 О чём этот конспект: Пошаговое руководство по использованию 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 позволил автору выделить критические правила, которые предотвращают «поломку» проекта.

Выгода: Стабильный код и отсутствие багов при масштабировании приложения.

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

1. Clear Instructions: Всегда имейте актуальный instructions.md.
2. Feature Splitting: Стройте одну фичу за раз, тестируйте её и только потом идите дальше.
3. Docs Snippets: Вставляйте куски документации в контекст ИИ.
4. New Chats: Начинайте новый чат для каждой новой фичи, чтобы очистить контекст от старых ошибок.
5. App Running: Держите npm run dev включенным, чтобы сразу видеть изменения.
6. Image Debugging: Используйте скриншоты ошибок или UI для правок.
7. Partial Acceptance: Не принимайте весь код сразу, если ИИ затронул лишние файлы.
8. Safety Prompt: Добавляйте фразу "Do not mess up existing functionality" в каждый запрос.
9. Git Checkpoints: Делайте git commit после каждой рабочей фичи. Это ваш "Save Point".
10. O1 Model for Logic: Если Cascade зациклился на ошибке, скопируйте код в ChatGPT (модель o1) для глубокого анализа логики.

FAQ

В: Чем 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