Привет, на связи Бурый!
Я не люблю громкие заголовки. Но здесь по-другому не скажешь.
Последнюю неделю я работаю с OpenSpec — фреймворком для Spec-Driven Development (SDD). И это тот случай, когда обратно уже не хочется.
🎯 Что такое SDD и зачем это тебе
Классический сценарий работы с AI: ты пишешь промпт, AI генерирует код, ты смотришь, что получилось, и просишь переделать. И так по кругу.
Проблема в том, что требования живут только в истории чата. AI не помнит контекст. Ты не помнишь, что именно просил на прошлой итерации. А когда возвращаешься к проекту через неделю — вообще ничего не понятно.
Spec-Driven Development решает это иначе:
- Сначала пишешь спецификацию — что именно нужно сделать
- AI читает спецификацию и генерирует код
- Спецификация хранится в репозитории и остаётся единственным источником правды
Это не «документация ради документации». Это контракт между тобой и AI .
📦 Установка
Добавляем в закладки:
npm install -g @fission-ai/openspec@latest
С этой команды начинается разработка. Дальше в корне проекта:
openspec init
OpenSpec спросит, какие AI-инструменты ты используешь. У меня Cline (я на Mac) — он в списке поддерживаемых . После инициализации в проекте появятся скиллы и директория openspec/.
🗂 Как я работаю с репозиториями
Тут важный момент. Я работаю сразу над проектом, у которого несколько репозиториев в одной рабочей директории. И папка openspec/ у меня не попадает в репозиторий с кодом.
Спецификации я храню в отдельном репозитории.
Но сам подход не регламентирует, как вам хранить спецификации. Это пока что остаётся на усмотрение команды. Я думаю, с развитием SDD такие тонкости тоже будут описаны. А пока — делай как удобно .
🔄 Рабочий процесс
После установки и инициализации у тебя уже всё готово.
Первый шаг — команда:
/openspec-explore
И дальше описываешь задачу своими словами. Это режим размышления: AI читает код, задаёт вопросы, помогает сформулировать требования. Он не пишет код на этом этапе.
С этого момента AI ведёт тебя по flow и ведет тебя по шагам от формирования требований к финальному коду, просто следуй инструкциям!
🔥 Почему это работает
Спецификация — это контракт. AI не гадает, что ты имел в виду. Он читает чётко сформулированные требования и следует им.
Дельта-спецификации. OpenSpec не заставляет описывать всю систему. Ты пишешь только то, что меняется. Это идеально для существующих проектов.
Спецификации накапливаются. Каждый заархивированный change сливается в основную спецификацию. Через несколько итераций у тебя есть живое описание системы, которое AI читает перед каждой новой задачей.
🎯 Мой вывод
Я не буду говорить, что это серебряная пуля.
Порог входа. Нужно привыкнуть думать «спецификациями», а не промптами.
Дисциплина. Если ты пропускаешь шаг спецификации и сразу просишь код — OpenSpec не сработает.
Тулинг молодой. Фреймворк активно развивается. Какие-то вещи (например, хранение спецификаций отдельно от кода) пока не регламентированы.
Советую начать пользоваться и делиться впечатлениями.
Это не инструкция. Просто рассказ о том, как я работаю и что меня зацепило.
Если ты ещё не используешь SDD — сейчас самое время попробовать.
👇 А ты пробовал OpenSpec? Как впечатления?
Обсудить пост:
- Max → https://max.ru/channel_buriy
- Telegram → https://t.me/buriy_dev
🔥 И не забудь подписаться :)