Вайбкодинг — это круто, пока проект не разрастается. Главные проблемы при работе с агентами вроде Claude Code — потеря контекста после /clear и отсутствие инженерной дисциплины (AI редко пишет тесты сам). Решение — Spec-Driven Development (SDD), где во главе угла стоит не промпт, а артефакты.

Что такое OpenSpec?

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

1. proposal.md — зачем и что меняем.
2. design.md — выбор технологий и риски.
3. specs/*.md — требования в формате Gherkin (When/Then).
4. tasks.md — чек-лист для реализации.

Поскольку всё это лежит в папке openspec/, вы можете смело чистить контекст чата — агент прочитает файлы и продолжит работу ровно с того места, где остановился.

Superpowers: Дисциплина для агента

Если OpenSpec отвечает за «что делать», то расширение Superpowers контролирует «как». Оно внедряет в Claude Code навыки (Skills), которые заставляют AI следовать TDD-практикам и проводить двухэтапное код-ревью.

Как это работает вместе

Связка OpenSpec + Superpowers создает «тонкую архитектуру оркестрации». Вы используете команды sdd-*, которые под капотом вызывают обе системы.

Основные команды:

• /opsx:ff — быстрый проход: генерация всех артефактов из одного описания.
• /opsx:apply — пошаговое выполнение задач из tasks.md.
• /opsx:verify — проверка реализации на соответствие спекам.

Установка:

npm install -g @fission-ai/openspec@latest
cd your-project
openspec init

Итог для вайбкодера

Этот подход превращает Claude Code из «умного чат-бота» в системного инженера. Вы перестаете плодить технический долг, так как AI сначала проектирует решение, фиксирует его в Markdown, а затем реализует через тесты. Для сложных продуктов, где важна поддержка API (например, интеграция с Apifox), это единственный способ не сойти с ума от галлюцинаций модели.