VibeCoderzVibeCoderz

Конспекты

Смарт-конспекты YouTube-видео — ключевые идеи и инсайты без необходимости смотреть часовые ролики

Все конспекты
📝 Конспект2026/03/19

OpenSpec: Полный гид по Specification-Driven Development для вайбкодеров

Узнайте, как использовать OpenSpec для управления AI-агентами через спецификации. Пошаговая настройка для Cursor, Copilot и Windsurf без галлюцинаций AI.

Содержание (6)+
📝

Смарт-конспект

🎯 О чём этот конспект: Разбор OpenSpec — опенсорсного фреймворка для управления AI-агентами (Cursor, GitHub Copilot, Windsurf) через спецификации. Вместо хаотичного промптинга предлагается метод «сначала проект, потом код», что исключает галлюцинации AI и поломку архитектуры при масштабировании проекта.

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

✨ Что получите: Пошаговый алгоритм настройки OpenSpec, который превратит ваш AI-агент в дисциплинированного исполнителя, работающего по строгому техническому заданию и отслеживаемому списку задач.

1. Проблема «сырого» промптинга и решение через OpenSpec

Контекст: При работе с Cursor или Claude Code часто возникает ситуация: вы просите добавить фичу, и AI выдает рабочий код, который ломает существующую логику или не соответствует вашему видению архитектуры. Это происходит из-за отсутствия «единого источника правды». OpenSpec решает это через Specification-Driven Development (SDD). В отличие от своего предшественника SpecKit, OpenSpec разделяет текущие спецификации и предлагаемые изменения (папка changes), что позволяет безопасно масштабировать проект без потери контроля.

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

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

  • Шаг 1: Понимание философии — Примите правило: «Сначала фиксируем намерение (Intent), затем внедряем (Implement)». Никакого кода, пока AI и вы не согласуете спецификацию.
  • Шаг 2: Выбор агента — OpenSpec работает как надстройка. Вы можете использовать его с Cursor, Windsurf или VS Code (Copilot).

2. Установка и инициализация окружения

Контекст: OpenSpec — это CLI-инструмент (интерфейс командной строки), который не требует API-ключей или регистрации. Он работает локально и подготавливает структуру папок, которую ваш AI-агент будет использовать как инструкцию.

Выгода: Быстрый старт без затрат на подписки (кроме вашего основного AI-агента).

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

  • Шаг 1: Установка CLI — Убедитесь, что у вас установлен Node.js, и выполните команду в терминале:
npm install -g openspec
  • Шаг 2: Проверка версии — Убедитесь, что установка прошла успешно:
openspec --version
  • Шаг 3: Инициализация в проекте — Перейдите в папку вашего проекта и запустите:
openspec init
  • Шаг 4: Выбор агента — В появившемся меню выберите ваш инструмент (например, cursor или github-copilot). OpenSpec создаст файлы конфигурации, оптимизированные под конкретный AI.

Результат: В корне проекта появятся файлы agent.md (инструкции для AI) и project.md (контекст проекта).


3. Настройка контекста проекта (Single Source of Truth)

Контекст: Чтобы AI понимал ваш стек (например, Next.js + Tailwind + Supabase), нужно заполнить project.md. OpenSpec автоматизирует этот процесс, предлагая специальный промпт, который заставляет AI проанализировать ваши файлы и задокументировать архитектурные решения.

Выгода: AI перестает предлагать неподходящие библиотеки или паттерны проектирования.

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

  • Шаг 1: Копирование промпта — OpenSpec предоставит шаблон промпта для инициализации контекста.
  • Шаг 2: Запуск в AI-чате — Вставьте промпт в ваш AI-агент (например, в Cursor Composer или Copilot Chat):
Read the OpenSpec project.md file and help me fill out all the relevant details about my project: tech stack, architecture preferences, testing approach, and coding standards.
  • Шаг 3: Верификация — Проверьте обновленный project.md. Теперь это официальный документ, на который AI будет ссылаться при создании каждой новой функции.

4. Создание предложений по изменениям (Proposals)

Контекст: Вместо команды «сделай страницу задач», вы инициируете процесс предложения. AI создает черновик в папке changes, описывая дизайн, список задач (task list) и спецификации компонентов до написания кода.

Выгода: Вы можете проверить логику реализации до того, как AI изменит файлы проекта.

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

  • Шаг 1: Формирование запроса — Используйте шаблон для запроса фичи:
I want to create an OpenSpec changes proposal for the core task management feature. Include: task creation, project organization, and status tracking.
  • Шаг 2: Анализ папки changes — AI создаст файлы:
    • design.md — технический подход.
    • tasks.md — пошаговый план работ.
    • specs/ — детальное описание поведения компонентов.

5. Имплементация и мониторинг прогресса

Контекст: Когда спецификация утверждена, вы даете команду на выполнение. AI следует строго по списку задач из tasks.md. Вы можете в реальном времени наблюдать за тем, что делает агент.

Выгода: Полная прозрачность процесса. Если AI отклонится от плана, вы заметите это на раннем этапе.

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

  • Шаг 1: Команда на внедрение — В чате AI напишите:
Implement the feature according to the OpenSpec proposal. Follow the specification exactly and do not add any extra features beyond what was defined.
  • Шаг 2: Визуализация прогресса — В отдельном терминале запустите команду для отслеживания статуса задач:
openspec view

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


OpenSpec: ответы на частые вопросы

В: Чем OpenSpec лучше обычного промпта в Cursor? О: Обычный промпт не имеет структуры. OpenSpec заставляет AI сначала составить план (спецификацию), который вы одобряете. Это исключает ситуацию, когда AI «забывает» старый код или нарушает архитектуру проекта.

В: Нужно ли мне платить за OpenSpec? О: Нет, это бесплатный инструмент с открытым исходным кодом. Вам нужно оплачивать только подписку на ваш AI-агент (например, Cursor или Claude).

В: Можно ли использовать OpenSpec для уже существующих проектов? О: Да. При запуске openspec init в существующем проекте, AI просканирует текущий код и создаст project.md на основе того, что уже написано, помогая стандартизировать дальнейшую разработку.

В: Что делать, если AI предложил плохой дизайн в Proposal? О: Вы просто просите AI отредактировать файлы в папке changes до того, как начнется стадия implement. Это экономит время, так как переписать текстовое описание проще, чем исправлять сотни строк кода.

В: Какие AI-агенты поддерживаются официально? О: На данный момент это GitHub Copilot, Cursor, Windsurf и стандартные CLI-агенты. Список постоянно пополняется через обновления npm-пакета.

Конспект создан на основе видео «OpenSpec: The Future of AI Coding?» канала AI Master. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=UtZyvtexJRM

Редактор конспекта

Максим Наговицын

Маркетинг-стратег, IT-предприниматель, ментор по вайбкодингу

10+ лет в маркетинге, 300+ клиентских проектов: сайты, реклама, боты. Создатель GoBanana (228K+ пользователей, 11.6 млн ₽ выручки) и VibeCoderz. Делаю AI-продукты сам через Claude Code, Cursor, Windsurf и консультирую тех, кто хочет так же.

Об авторе →
Все конспекты

Источник

КаналAI Master
Конспект добавлен2026/03/19
Смотреть на YouTube

Инструменты из конспекта

Похожие конспекты

📝 Конспект

Graphify: Как создать карту знаний для AI-агентов и экономить до 70% токенов

Пошаговый гайд по Graphify: установка, настройка графа знаний для Claude Code и Cursor, оптимизация контекста и экономия токенов в больших проектах.

2026/06/16
📝 Конспект

Эволюция в AI-генералиста: Как выжить и заработать в эпоху AI-агентов

Пошаговый гайд по переходу в AI-генералиста. 5 уровней обучения, автоматизация контента на 200 млн просмотров и бизнес-идеи для вайбкодеров.

2026/05/14
📝 Конспект

Lifetime Deal (LTD): Как заработать $100,000 за 24 часа на запуске мобильного приложения

Пошаговый кейс запуска приложения Floa: стратегия Lifetime Deal, email-прогрев на 5 недель и психология ценообразования для выручки $100k+ в первый день.

2026/04/28
📝 Конспект

B2B SaaS Маркетинг 2026: «Большая пятерка» стратегий в эпоху AI

5 ключевых стратегий маркетинга для B2B SaaS: SEO, PPC, холодные продажи, интеграции и контент. Как использовать AI и MCP для роста стартапа.

2026/04/28
📝 Конспект

Роль CAIO и стратегия внедрения Generative AI: Практическое руководство от Leidos

Как внедрить ИИ в корпорацию: метрики успеха, модель Hub and Spoke, борьба с Legacy-кодом и советы от CAIO компании Leidos.

2026/04/17
📝 Конспект

Революция AI-интерфейсов и кредитная модель оплаты: Будущее софта после SaaS

Михаил Таковинин о смерти UI/UX, переходе к AI-агентам и новой бизнес-модели оплаты за функции (Credits) вместо подписок.

2026/04/16

Читать далее

📢 Новость

GitHub выпустил Copilot Desktop: прямой конкурент Cursor и Windsurf

GitHub представил нативное десктопное приложение Copilot, ориентированное на агентную разработку и глубокую интеграцию с ОС.

2026/05/23
📢 Новость

Рынок AI-кодинга в 2026 году: Cursor и Windsurf теснят GitHub Copilot

Обзор рынка AI-инструментов 2026 года: более 51% кода на GitHub пишет нейросеть, а Cursor и Windsurf захватывают доли рынка.

2026/03/15
📢 Новость

Рынок AI-кодинга в 2026: Cursor и Windsurf теснят GitHub Copilot

Обзор рынка AI-инструментов для разработки в 2026 году: от доминирования Copilot до расцвета локальных моделей и опенсорс-решений вроде Continue.

2026/03/15
📄 Статья

Среда разработки для Python: как выбрать IDE и настроить её с ИИ

Выбирая IDE для Python в 2026 году, сравните три главных варианта: Cursor, Windsurf и VS Code + Copilot, и узнайте, как настроить их с AI, виртуальными окружениями и отладчиком.

2026/06/2410 мин
📄 Статья

Нейросеть для программирования на Python, какую модель подключить в 2026

Найти подходящую нейросеть для Python в 2026 проще, чем кажется: Claude Sonnet 4.6 в Cursor или Windsurf – лучший баланс цены и качества, а DeepSeek V4 Flash и Qwen3 Coder 480B подойдут для экономичных и self‑host решений.

2026/06/1713 мин
📄 Статья

Цена ИИ для программирования в 2026 Claude GPT-5 DeepSeek и Qwen

Июнь 2026 — рынок ИИ для программирования разбился на четыре ценовые сегмента: премиум‑Claude и GPT‑5, средний‑Sonnet и Qwen, value‑DeepSeek и MiniMax, а также бесплатные модели. Выбор зависит от того, насколько критичен уровень качества и готовность платить.

2026/06/1712 мин