VibeCoderzVibeCoderz

Конспекты

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

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

OpenSpec: Полный гид по Spec-Driven разработке для AI-агентов

Узнайте, как использовать OpenSpec для структурирования AI-разработки, экономии токенов и создания сложных фич без багов через систему спецификаций.

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

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

🎯 О чём этот конспект: Разбор OpenSpec — легковесного инструмента для управления процессом разработки через спецификации (Spec-Driven Development). Инструмент решает проблему «потери контекста» в длинных чатах с AI и экономит токены, разбивая задачу на четкие документы, предложения по изменениям (proposals) и атомарные задачи.

👤 Кому будет полезно: Вайбкодерам, разработчикам на Cursor, Claude Code и Windsurf, которые сталкиваются с тем, что AI начинает «тупить» или забывать требования на больших проектах.

✨ Что получите: Вы научитесь структурировать разработку так, чтобы AI-агент (например, Claude Code) работал по строгому плану, не галлюцинировал и успешно внедрял сложные фичи (графики, экспорт данных, темы оформления) с первой попытки.

1. Концепция Spec-Driven Development в OpenSpec

Контекст: При обычном промптинге требования часто «замыливаются» в истории чата, а AI тратит лишние токены на перечитывание всего контекста. OpenSpec внедряет методологию из трех шагов: черновик предложения (Draft), ревью задач (Review) и имплементация (Implement). Это превращает расплывчатые идеи в структурированные Markdown-файлы, которые служат «картой» для AI-агента. Такой подход минимизирует баги и позволяет четко отслеживать прогресс выполнения каждой подзадачи.

Выгода: Экономия токенов до 40-60% за счет передачи только нужного контекста и повышение точности выполнения сложных инструкций.

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

  • Шаг 1: Инициализация проекта — В терминале вашего проекта (например, Vite + React) выполните команду для создания структуры OpenSpec.
  • Шаг 2: Выбор агента — Выберите AI-инструмент, который вы используете (например, claude-code).
  • Шаг 3: Настройка окружения — OpenSpec создаст файл agent.md и папку .openspec/, где будут храниться все инструкции.
# Инициализация OpenSpec в корне проекта
npx openspec init

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


2. Создание и управление предложениями по изменениям (Change Proposals)

Контекст: Вместо того чтобы просить AI «сделай мне инструмент для графиков», вы создаете Change Proposal. Это отдельная папка внутри .openspec/, которая содержит описание конкретной фичи и список задач. Это позволяет изолировать разработку разных функций и даже работать над несколькими фичами параллельно, не смешивая контекст.

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

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

  • Шаг 1: Заполнение деталей проекта — Попросите AI-агента заполнить основной файл проекта на основе текущего кода.
  • Шаг 2: Создание предложения — Используйте команду для описания новой фичи. Например, создание инструмента для построения графиков с поддержкой тем.
  • Шаг 3: Ревью задач — Проверьте созданный файл tasks.md. Если там есть лишние шаги (например, ненужные тесты), попросите AI их удалить.
# Пример команды для создания предложения внутри чата с агентом
/openspec add "Создать инструмент для построения столбчатых диаграмм с редактированием легенды, цветов и переключением тем"

Результат: Создана папка с файлами proposal.md (описание) и tasks.md (чек-лист), по которым агент будет работать.


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

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

Выгода: Прозрачный процесс разработки и возможность визуально подтвердить завершение каждого этапа.

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

  • Шаг 1: Запуск выполнения — Используйте команду apply, чтобы агент начал кодить по списку задач.
  • Шаг 2: Мониторинг — В отдельном окне терминала запустите визуализатор прогресса.
  • Шаг 3: Завершение — После выполнения всех задач проверьте результат в приложении.
# Запуск выполнения задач
/openspec apply
 
# Просмотр прогресса в реальном времени
npx openspec view
 
# Список всех активных изменений и количество задач
npx openspec list

Результат: Полностью реализованная фича с обновленным статусом в tasks.md.


4. Итеративное улучшение и архивация

Контекст: После реализации первой версии часто требуются правки (багфиксы или улучшения). OpenSpec позволяет архивировать выполненные задачи, чтобы они не занимали место в активном контексте, и создавать новые точечные предложения для исправлений. Это поддерживает чистоту проекта на протяжении всего цикла разработки.

Выгода: Чистый контекст для AI-агента, отсутствие «мусорных» файлов в активной работе.

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

  • Шаг 1: Архивация выполненного — Перенесите завершенную фичу в архив.
  • Шаг 2: Создание точечных правок — Создайте новые предложения для конкретных багов (например, исправить позицию легенды или улучшить разрешение экспорта).
  • Шаг 3: Параллельная работа — Вы можете создать несколько предложений одновременно и переключаться между ними.
# Архивация завершенного предложения
/openspec archive
 
# Создание предложения на исправление конкретного бага
/openspec add "Исправить позицию легенды: при выборе 'bottom' легенда должна уходить вниз"

Результат: Структурированная история изменений в папке archive и быстрое исправление ошибок без поломки основного функционала.


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

В: Чем OpenSpec лучше обычного чата в Cursor? О: В обычном чате инструкции теряются при прокрутке. OpenSpec фиксирует их в Markdown-файлах. Агент всегда видит «карту» проекта и текущую задачу, что резко снижает количество ошибок в логике.

В: Какие AI-агенты поддерживаются? О: На данный момент лучше всего работает с Claude Code и Open Code. Список поддерживаемых агентов постоянно расширяется, так как инструмент активно развивается Fishian AI.

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

В: Как OpenSpec экономит токены? О: Он не отправляет всю историю чата при каждом запросе. Агент фокусируется только на файле tasks.md и proposal.md текущей задачи, что значительно сокращает объем передаваемого текста.

В: Что делать, если AI неправильно составил список задач? О: Вы можете вручную отредактировать файл tasks.md в VS Code или промптом попросить агента: «Обнови задачи, убери пункт с интеграционными тестами и добавь шаг по оптимизации SVG».

Конспект создан на основе видео «OpenSpec: Spec-Driven Development Tool» канала Fishian. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=cQv3ocbsKHY

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

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

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

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

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

Источник

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

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

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

📝 Конспект

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

Узнайте, как использовать OpenSpec для создания надежных AI-проектов через спецификации, визуальную валидацию и авто-документацию.

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

Метод Карпати: Как дать Claude Code вечную память и снизить расход токенов на 95%

Пошаговый гид по созданию системы долгосрочной памяти для AI-агентов с помощью Markdown-вики. Экономия токенов, автоматизация сессий и настройка Obsidian.

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

Создание кроссплатформенного AI-ассистента за 1 день: Эмуляторы, скриншот-верификация и автомердж PR

Пошаговый разбор создания open-source AI-бота Ricazo: архитектурная изоляция, тестирование через эмуляторы API, скриншоты и автономный CI/CD.

2026/11/02
📝 Конспект

Higgsfield AI + Claude Code: Создание анимированного маскота и лендинга под ключ

Пошаговый гайд по созданию лендинга с анимированным ИИ-маскотом через Claude Code и Higgsfield AI Influencer 2.0.

2026/11/02
📝 Конспект

Claude Code AIOS: Как создать персональную операционную систему на базе ИИ-агентов

Пошаговый гид по созданию персональной AIOS в Claude Code: фреймворки 3M и 4C, скиллы, GWS CLI, база знаний LLM Wiki и автономные Cloud Routines.

2026/11/02
📝 Конспект

Ферма Instagram-аккаунтов в облаке: Масштабирование трафика через Device Farm, прокси и AI

Пошаговый гайд по созданию фермы из 20+ Instagram-аккаунтов в Device Farm: мобильные SOCKS5-прокси, обход банов, экспресс-прогрев и AI-автоматизация.

2026/11/02

Читать далее

📢 Новость

OpenSpec: фреймворк для Spec-Driven разработки в Cursor и Claude Code

Забудьте о хаосе в чатах. OpenSpec внедряет структуру SDD (Specification-Driven Development) прямо в ваш AI-стек, делая Markdown единственным источником правды.

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

OpenSpec + Superpowers: Как внедрить SDD-воркфлоу в Claude Code

Разбираем связку OpenSpec и Superpowers для реализации Spec-Driven Development. Как заставить AI-агентов писать код по спецификациям и соблюдать дисциплину TDD.

2026/04/29
📢 Новость

Тест OpenSpec: спек-дривен разработка против вайбкодинга

Разбираем OpenSpec — инструмент для внедрения Spec-Driven Development в AI-агенты. Поможет ли строгий план избежать ошибок Claude Code?

2026/04/14
📄 Статья

Spec-Driven Development как избежать галлюцинаций AI-агента в 2026

Spec-driven development, или SDD, это методология разработки с AI-агентами, где перед кодом пишется спецификация, потом план, потом список задач, и только после этого агент садится за реализацию. Метод решает конкретную проблему вайбкодинга: агент до…

2026/08/1210 мин
📄 Статья

Вайбкодинг для 1С 2026: MCP-серверы и первые шаги

Обеспечьте надёжный 1С‑код, ставя MCP‑серверы в правильный стек: выберите подходящую IDE, настройте контекст и процесс, чтобы AI генерировал production‑ready решения, а не «галлюцинации».

2026/04/178 мин
📄 Статья

Claude Code: советы от создателя. Конспект доклада Бориса Черни из Anthropic

Борис Черни, автор Claude Code, показал на конференции Anthropic, как реально пользоваться инструментом: с чего начать, зачем CLAUDE.md, какие горячие клавиши никто не знает и как запускать несколько агентов параллельно. Конспект доклада с командами и разбором.

2026/08/1411 мин