Главная проблема AI-ассистентов не в том, что они плохо пишут код, а в том, что они часто пишут не то. Знакомая ситуация: просишь добавить темную тему, а нейронка переписывает половину CSS-переменных, меняет лейаут и ломает логику, хотя нужно было просто поправить токены. Контекст теряется, и в следующем чате AI снова начинает гадать.
OpenSpec — это инструмент, который внедряет Spec-Driven Development (SDD) в работу вайбкодера. Вместо того чтобы сразу бросаться в бой, AI сначала создает документ со спецификацией. Вы согласуете «что» и «как» делать, и только потом агент приступает к реализации.
Как это работает
OpenSpec разделяет знания о проекте на две части:
- specs/ — «источник истины», описание текущего поведения системы.
- changes/ — активные задачи. Каждое изменение живет в своей папке, что позволяет вести несколько фич параллельно без конфликтов.
Основной ворклоу: Propose → Apply → Archive
Процесс работы с OpenSpec выглядит максимально логично для тех, кто устал от «галлюцинаций» нейронок:
1. Propose (Предложение)
Команда /opsx:propose заставляет AI создать четыре артефакта:
proposal.md— зачем мы это делаем и что входит в рамки задачи.specs/— дельта-спецификация (что конкретно изменится в поведении).design.md— технический подход и архитектурные решения.tasks.md— чек-лист для реализации.
2. Apply (Реализация)
По команде /opsx:apply ассистент идет строго по пунктам из tasks.md. Он не отклоняется от сценария, а если вы прервете процесс, то в следующий раз он продолжит ровно с того места, где остановился.
3. Archive (Архивация)
Когда задача готова, /opsx:archive объединяет дельта-спеки с основным «источником истины» в папке specs/ и переносит задачу в архив. Так у вас формируется актуальная документация проекта, которую AI сможет использовать в будущем.
Почему это важно для вайбкодеров
Для тех, кто строит продукты через Cursor, Windsurf или Claude Code, OpenSpec — это способ перестать «бороться» с AI. Инструмент поддерживает более 30 ассистентов и позволяет:
- Избежать регрессий: AI всегда знает текущее состояние системы.
- Контролировать архитектуру: вы апрувите дизайн до того, как будет написана первая строчка кода.
- Масштабироваться: когда проект растет, OpenSpec помогает удерживать контекст, который не влезет ни в один prompt window.
Быстрый старт
Для работы нужен Node.js 20.19.0+:
npm install -g @fission-ai/openspec@latest
cd your-project
openspec initИнструмент уже набрал более 28к звезд на GitHub и распространяется под лицензией MIT. Если вы хотите, чтобы ваш AI-агент перестал гадать и начал проектировать — OpenSpec определенно стоит внедрить в свой стек.
