Главная проблема AI-ассистентов не в том, что они плохо пишут код, а в том, что они часто пишут не то. Знакомая ситуация: просишь добавить темную тему, а нейронка переписывает половину CSS-переменных, меняет лейаут и ломает логику, хотя нужно было просто поправить токены. Контекст теряется, и в следующем чате AI снова начинает гадать.

OpenSpec — это инструмент, который внедряет Spec-Driven Development (SDD) в работу вайбкодера. Вместо того чтобы сразу бросаться в бой, AI сначала создает документ со спецификацией. Вы согласуете «что» и «как» делать, и только потом агент приступает к реализации.

Как это работает

OpenSpec разделяет знания о проекте на две части:

1. specs/ — «источник истины», описание текущего поведения системы.
2. 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 определенно стоит внедрить в свой стек.